Create initiator

03/15/2022 Contributors

The create initiator command creates the initiator object.

Supported Arrays

This command applies to any individual storage array, including the E2700, E5600, E2800, E5700, EF600 and EF300 arrays, as long as all SMcli packages are installed.

Roles

To execute this command on an E2800, E5700, EF600, or EF300 storage array, you must have the Storage Admin role.

Context

This command replaces the deprecated Create iSCSI initiator command.

This command is only applicable to iSCSI, iSER, NVMe over RoCE, NVMe over InfiniBand, and NVMe over Fibre Channel.

Syntax

create initiator identifier="initiatorQualifiedName" userLabel="initiatorName" host="hostName"
interfaceType=(iscsi | iser | nvmeof) [chapSecret="securityKey"]

Parameters

Parameter Description

Parameter	Description
`identifier`	Allows you to specify the identifier qualified name (such as iqn or nqn) to create an initiator . Enclose the identifier in double quotation marks (" ").
`userLabel`	Allows you to specify a user label for the initiator. Enclose the name in double quotation marks (" ").
`host`	Allows you to specify the host name where the initiator is installed. Enclose the name in double quotation marks (" ").
`interfaceType`	Allows you to specify which interface type the initiator is for. Valid choices are: iscsi, iser, or nvmeof.
`chapSecret`	Allows you to enter the security key that you want to use to authenticate a peer connection. Enclose the security key in double quotation marks (" "). This parameter is applicable only to iSCSI and iSER host interface types.

identifier

Allows you to specify the identifier qualified name (such as iqn or nqn) to create an initiator . Enclose the identifier in double quotation marks (" ").

userLabel

Allows you to specify a user label for the initiator. Enclose the name in double quotation marks (" ").

host

Allows you to specify the host name where the initiator is installed. Enclose the name in double quotation marks (" ").

interfaceType

Allows you to specify which interface type the initiator is for. Valid choices are: iscsi, iser, or nvmeof.

chapSecret

Allows you to enter the security key that you want to use to authenticate a peer connection. Enclose the security key in double quotation marks (" "). This parameter is applicable only to iSCSI and iSER host interface types.

Minimum firmware level

8.41