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 Select Host to which initiator to be added EMCUnity​Host​Identity Y
Initiator Type Host initiator type EMCUnity​Host​Initiator​Type Y
IQN or WWN Enter IQN in case of ISCSI access or WWN in case of FC access gen_​text_​input Y
CHAP Username CHAP user name.​ Applies to i​SCSI initiators only.​ gen_​text_​input
CHAP Secret CHAP secret to use to authenticate i​SCSI sessions.​ Applies to i​SCSI initiators only.​ password
CHAP Secret Type CHAP secret encoding type.​ Applies to i​SCSI initiators only.​ EMCUnity​Chap​Secret​Type
Ignore Storage Access Specifies whether 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 Select Host for changing the host of initiator.​ Initiator will be removed from the existing host.​ EMCUnity​Host​Identity
Ignore Storage Access Specifies whether 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 Select EMC Unity Host Initiator to delete EMCUnity​Host​Initiator​Identity Y
Outputs
No Outputs