Emulex OneCommand Manager Application User Manual (P006979-01A Version 5.2, August 2011)

The OneCommand Manager User Manual Page 230
SetInitiatorProperties
Supported by: Windows, Solaris, Linux and VMware ESX
Syntax:
hbacmd [h=host_IP[:port] | hostname[:port]] SetInitiatorProperties
<MAC_Address> [Initiator_Name="initiator_name"]
[Initiator_Alias="initiator_alias"] [ImmediateData=<0|1>] [HeaderDigest=<0|1>]
[DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName"
"InitSecret"]
Description: This command sets the initiator properties for the specified port. It allows you to specify an
initiator name <Initiator_Name> and, an initiator alias <Initiator_Alias>. If you opt not to
specify these fields, a default iSCSI name is assigned. When you set authentication method <Auth> to
a value other than 0, you must set additional parameters to specify the initiator, target CHAP name, and
secret strings. Enclose these strings in quotations to avoid mishandling by the Windows, Linux, Solaris,
or VMware shell's parser.
Except for the Initiator_Name and Initiator_Alias properties, these properties are set as the target
portal's login properties to be used when discovering the targets on the target portal. The targets inherit
the target portal's properties when they are discovered. The discovered target's login properties can be
changed using the SetTargetProperties command.
Additionally, these properties are used for iSNS target discovery to set the discovered target's login
properties.
Example:
hbacmd SetInitiatorProperties 00-11-22-33-44-55 Auth=1 "TgtChapName"
"TargetSecret1"
If you specify the authentication method to "Mutual CHAP (value of 2)", you must specify all 4 values.
Example:
hbacmd SetInitiatorProperties 00-11-22-33-44-55 Auth=2 "TgtChapName"
"TargetSecret1" "InitCHAPName" "InitialSecret1"
Parameters:
MAC_Address - MAC address of the CNA port
Initiator_Name - Initiator iSCSI name enclosed in quotes (string length: 1-224)
Initiator_Alias - Initiator iSCSI alias enclosed in quotes (string length: 0-32)
ImmediateData -
0 = No
1 = Yes (default: 1)
HeaderDigest -
0 = None
1= CRC32C (default: 0)
DataDigest -
0 = None
1= CRC32C (default: 0)