Emulex OneCommand Manager Command Line Interface User Manual (P006980-01A Version 5.2, August 2011)

OneCommand Manager Command Line Interface User Manual Page 60
SetTargetLoginProperties
Supported by: Windows, Solaris, Linux and VMware ESX
Syntax:
hbacmd [h=host_IP[:port] | hostname[:port]] SetTargetLoginProperties
<MAC_Address> <iscsi_target_name> [ImmediateData=<0|1>] [HeaderDigest=<0|1>]
[DataDigest=<0|1>] [Auth=<0|1|2> "TgtCHAPName" "TgtSecret" "InitCHAPName"
"InitSecret"]
Description: This command sets the login and authentication properties associated with a specific
target. This command requires that you specify a valid iSCSI target name <iscsi_target_name>. If
you do not specify some of the remaining properties, these options are set to their default values.
However, if no properties are changed, an error is generated. You must change at least one property for
this command to return successfully. When you set the authentication method <Auth> to a value other
than 0, you must set additional parameters to specify the initiator CHAP name, target CHAP name, and
initiator and target secret strings. Each string should be enclosed in quotations to avoid mishandling by
the Windows, Linux, Solaris, or VMware shell's parser.
Example:
hbacmd SetTargetLoginProperties 00-11-22-33-44-55 iscsitarget Auth=1
"TgtCHAPName" "TargetSecret1"
If you set the authentication method to "Mutual CHAP (value of 2)", you must also specify all 4 values.
Example:
hbacmd SetTargetLoginProperties 00-11-22-33-44-55 iscsitarget Auth=2
"TgtChapName" "TargetSecret1" "InitCHAPName" "InitialSecret1"
Parameters:
MAC_Address - MAC address of the CNA port
iscsi_target_name - Target’s iSCSI name enclosed in quotes (string length:11-255)
ImmediateData -
0 = No
1 = Yes (default: 1)
HeaderDigest -
0 = None
1= CRC32C (default: 0)
DataDigest -
0 = None
1= CRC32C (default: 0)
Auth -
0 = None
1= One-Way CHAP
2 = Mutual CHAP (default: 0)
TgtCHAPName - Target CHAP name enclosed in quotes (string length: 1-255)