EMC Unity - Host Operations

This chapter contains the following sections:

EMC Unity - Create Host

Summary
Create a new host on an EMC Unity array.
Description
This task creates or adds a new host on an EMC Unity storage array. A host can have both FC and iSCSI initiators. You can associate Host IP Port (Network address) using EMC Unity Create Host IP Port. Input format:
  • EMC Unity Account Name: podName@AccountName. For example: Vblock@Unity_Hybrid.
  • Name: A valid host name. The following 19 special characters are not allowed in the host name: " % & ' * + . / \ : ; < = > ? ^ @ | ,
  • Description: A description of the host.
  • Operating System: Select the operating system running on the host.
Inputs
Input Description Mappable To Type Mandatory
EMC Unity Account Select EMC Unity account to add host EMCUnity​Account​Identity Y
Name Enter the host name.​ The following 19 special characters are not allowed:", %, &, ', *, +, .​, /, \, :, ;, <, =, >, ?, ^, @, | and ," gen_​text_​input
Description Enter a description for the host gen_​text_​input
Operating System Choose an operating system to run on the new host EMCUnity​Host​OSType
Outputs
Output Description Type
OUTPUT_​EMC_​UNITY_​ACCOUNT_​IDENTITY EMC Unity Account Identity.​ EMCUnity​Account​Identity
OUTPUT_​EMC_​UNITY_​HOST_​IDENTITY EMC Unity Host Identity.​ EMCUnity​Host​Identity

EMC Unity - Delete Host

Summary
Delete (unregister) a host object from an EMC Unity array.
Description
This task unregisters a host from an EMC Unity storage array. Delete EMC Unity Host is the rollback task for Create EMC Unity Host. If the host is associated with any initiators, all the initiators are deleted along with the host. This task fails if the selected host has access to any storage resources, such as a LUN or a consistency group. Input format for the EMC Unity host: podName@AccountName@hostName@hostID. For example: Vblock@Unity_Hybrid@TestHost@Host_1.
Inputs
Input Description Mappable To Type Mandatory
EMC Unity Host Choose an EMC Unity Host to be deleted EMCUnity​Host​Identity Y
Outputs
No Outputs

EMC Unity - Modify Host

Summary
Modify an EMC Unity Host on an EMC Unity array.
Description
This task modifies an existing host on an EMC Unity storage array. You can modify the name, description and operating system using this task. If the name is modified, all existing associations remain the same. Input format:
  • EMC Unity Host: podName@AccountName@hostName@hostID. For example: Vblock@Unity_Hybrid@TestHost@Host_1.
  • Name: A valid host name. The following 19 special characters are not allowed in the host name: " % & ' * + . / \ : ; < = > ? ^ @ | ,
  • Description: A description of the host.
  • Operating System: Select the operating system running on the host.
Inputs
Input Description Mappable To Type Mandatory
EMC Unity Host Select EMC Unity Host to modify EMCUnity​Host​Identity Y
Name Enter the modified host name.​ The following 19 special characters are not allowed:", %, &, ', *, +, .​, /, \, :, ;, <, =, >, ?, ^, @, | and ," gen_​text_​input
Description Enter a description for the host gen_​text_​input
Operating System Choose an operating system to run on the modified host EMCUnity​Host​OSType
Outputs
Output Description Type
OUTPUT_​EMC_​UNITY_​ACCOUNT_​IDENTITY EMC Unity Account Identity.​ EMCUnity​Account​Identity
OUTPUT_​EMC_​UNITY_​HOST_​IDENTITY EMC Unity Host Identity.​ EMCUnity​Host​Identity