Set iSCSI initiator
The set iscsiInitiator command sets the attributes for an iSCSI initiator.
Supported Arrays
This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.
Roles
To execute this command on an storage array, you must have the Storage Admin role.
Syntax
set iscsiInitiator (["<var id="GUID-EF0CB17D-FCD1-4DD1-B44D-2C29B5CA6973__V1175206" className="keyword varname">initiatorUserLabel</var>"] | <"<var id="GUID-EF0CB17D-FCD1-4DD1-B44D-2C29B5CA6973__V1696877" className="keyword varname">iscsiInitiatorName</var>">)
(userLabel="<var id="GUID-EF0CB17D-FCD1-4DD1-B44D-2C29B5CA6973__V1175207" className="keyword varname">newName</var>" |
host="<var id="GUID-EF0CB17D-FCD1-4DD1-B44D-2C29B5CA6973__V1175208" className="keyword varname">newHostName</var>" |
chapSecret="<var id="GUID-EF0CB17D-FCD1-4DD1-B44D-2C29B5CA6973__V1175209" className="keyword varname">newSecurityKey</var>")
Parameters
| Parameter | Description |
|---|---|
| initiatorUserLabel | The iscsi Initiator user label of the iSCSI initiator for which you want to set attributes. Enclose the iSCSI initiator user label in double quotation marks (" ") inside square brackets ([ ]). Note Begin the initiator user label with the host name to which the host port is connected. Because there can be more than one host port identifier on a host, use a unique suffix for the host port ID. If the host name is |
| iscsiInitiatorName | The name of the initiator for which you want to set attributes. Enclose the iscsiInitiatorName in double quotation marks (" ") inside angle brackets (< >). Note The |
| userLabel | The new user label that you want to use for the iSCSI initiator. Enclose the new user label in double quotation marks (" "). Note A best practice is to begin the initiator user label with the host name to which the host port is connected. Because there can be more than one host port identifier on a host, use a unique suffix for the host port ID. If the host name is |
| host | The name of the new host to which the host port is connected. Enclose the host name in double quotation marks (" "). An example is shown below: |
| chapSecret | The security key that you want to use to authenticate a peer connection. Enclose the security key in double quotation marks (" "). |
Notes
You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Names can have a maximum of 30 characters.
Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection. CHAP is based upon the peers sharing a secret . A secret is a security key that is similar to a password.
Use the chapSecret parameter to set up the security keys for initiators that require a mutual authentication. The CHAP secret must be between 12 characters and 57 characters. This table lists the valid characters.
| Space | ! | " | # | $ | % | & | ' | ( | ) | * | + |
| , | - | . | / | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 |
| 8 | 9 | : | ; | < | = | > | ? | @ | A | B | C |
| D | E | F | G | H | I | J | K | L | M | N | O |
| P | Q | R | S | T | U | V | W | X | Y | Z | [ |
| \ | ] | ^ | _ | ' | a | b | c | d | e | f | g |
| h | i | j | k | l | m | n | o | p | q | r | s |
| t | u | v | w | x | y | z | { | | | } | ~ |