EMC Unity - Host Initiator Operations

This chapter contains the following sections:

EMC Unity - Add Host Initiator

Summary

Add a new host initiator for a host on an EMC Unity array.

Description

This task creates or adds a new host initiator for a host on an EMC Unity storage array. Host can contain both FC and iSCSI initiators This task creates the following types of host initiators:

• ISCSI initiator - iSCSI Qualified Name (IQN)
• FC Initiator - Worldwide Name (WWN)

Input Format:

• EMC Unity Host Identity: podName@AccountName@hostName@hostID. For example: Vblock@Unity_Hybrid@TestHost@Host_1
• Initiator Type: Select the initiator Type. For example, ISCSI or FC
• IQN or WWN: Valid IQN or WWN-Enter IQN in case of iSCSI access or WWN in case of FC access
• Ignore Storage Access: Check box-Specifies whether to include the host initiator when storage access is granted to the host.
• CHAP Username: Valid name-CHAP user name-Applies to iSCSI initiators only.
• CHAP Secret: CHAP secret to use to authenticate iSCSI sessions. Applies to iSCSI initiators only.
• CHAP Secret Type: CHAP secret encoding type. Applies to iSCSI initiators only.

Inputs

Input	Description	Mappable To Type	Mandatory
EMC Unity Host Identity	Choose a host to which to add the initiator	EMCUnity​Host​Identity	Y
Initiator Type	Choose an initiator type	EMCUnity​Host​Initiator​Type	Y
IQN or WWN	Enter a IQN (for i​SCSI access) or WWN (for FC access)	gen_​text_​input	Y
CHAP Username	Enter a CHAP username.​ Applies to i​SCSI initiators only.​	gen_​text_​input
CHAP Secret	Enter a CHAP secret to use to authenticate i​SCSI sessions.​ Applies to i​SCSI initiators only.​	password
CHAP Secret Type	Choose a CHAP secret encoding type.​ Applies to i​SCSI initiators only.​	EMCUnity​Chap​Secret​Type
Ignore Storage Access	Check to include the host initiator when storage access is granted to the host.​	Boolean

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
OUTPUT_​EMC_​UNITY_​HOST_​INITIATOR_​IDENTITY	EMC Unity Host Initiator Identity.​	EMCUnity​Host​Initiator​Identity
OUTPUT_​EMC_​UNITY_​INITIATOR_​WWN_​IQN	EMC Unity Initiator WWN/IQN.​	EMCUnity​Initiator​WWN/IQN

EMC Unity - Modify Host Initiator

Summary

Modify a host initiator on an EMC Unity array.

Description

This task modifies a Host Initiator on an EMC Unity storage array. For an FC Initiator, the host can be changed. For an ISCSI Initiator, other inputs like chap user, chap secret, and chap secret type also can be changed. Input Format:

• EMC Unity Initiator: podName@AccountName@hostName@hostID@initiatorType@iqn/wwn@initiatorID. For example: Vblock@Unity_Hybrid@TestHost@Host_1@fc@20:00:00:25:B5:00:00:0F:20:00:00:25:B5:00:0B:2F@HostInitiator_3
• Host: podName@AccountName@hostName@hostID. For example: Vblock@Unity_Hybrid@TestHost@Host_1
• Ignore Storage Access: Check box-Specifies whether to include the host initiator when storage access is granted to the host.

Inputs

Input	Description	Mappable To Type	Mandatory
Initiator	Select Initiator to modify	EMCUnity​Host​Initiator​Identity	Y
EMC Unity Host Identity	Choose a new EMC Unity host for the initiator.​ The initiator is removed from the existing host.​	EMCUnity​Host​Identity
Ignore Storage Access	Check to include the host initiator when storage access is granted to the host.​	Boolean

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
OUTPUT_​EMC_​UNITY_​HOST_​INITIATOR_​IDENTITY	EMC Unity Host Initiator Identity.​	EMCUnity​Host​Initiator​Identity
OUTPUT_​EMC_​UNITY_​INITIATOR_​WWN_​IQN	EMC Unity Initiator WWN/IQN.​	EMCUnity​Initiator​WWN/IQN

EMC Unity - Remove Host Initiator

Summary

Remove a host initiator from a host on an EMC Unity array.

Description

This task deletes a host initiator and all of its paths from a host. Initiator can not be deleted if there are storage resources. For example: LUN or Consistency group associated with the host. This task is also the rollback task for Add EMC Unity Host Initiator. Input Format:

• EMC Unity Host Initiator: podName@AccountName@hostName@hostID@initiatorType@iqn/wwn@initiatorID. For example: Vblock@Unity_Hybrid@TestHost@Host_1@fc@20:00:00:25:B5:00:00:0F:20:00:00:25:B5:00:0B:2F@HostInitiator_3

Inputs

Input	Description	Mappable To Type	Mandatory
EMC Unity Host Initiator	Choose an EMC Unity Host Initiator to be deleted	EMCUnity​Host​Initiator​Identity	Y

Outputs

No Outputs