HP-UX iSCSI Software Initiator Support Guide (Edition 7)

A Login Key Configuration
A.1 Configuring iSCSI Login Keys
In accordance with the iSCSI protocol, an iSCSI initiator must negotiate iSCSI login keys with each
iSCSI target to:
— enable an iSCSI connection
— authenticate the parties
— negotiate the session’s parameters
— mark the connection as belonging to an iSCSI session
All of the iSCSI login keys configured by default by the iSCSI Software Initiator apply to all of the
targets connected to the iSCSI host node. Currently, there are three iSCSI login keys that may be
configured by the user on a per target basis.
The three user configurable login keys are:
• HeaderDigest
• DataDigest
• AuthMethod (Authentication Method)
The default value for HeaderDigest is:
• None,CRC32C
The default value for DataDigest is:
• None,CRC32C
The default value for AuthMethod is:
• None
The user configurable login keys may be configured in one of the following ways:
— For all targets on a global basis
— For a particular Operational target.
— For a particular Discovery or Operational target address.
NOTE: A login key configured for all targets, applies to all targets and all target addresses that
are not already configured for that login key.
A login key configured for a particular Operational target will apply to all Operational target
addresses that are not already configured for that login key.
Unique iSCSI Sessions are opened for each Operational target address. The login keys configured
for a particular Operational target address correspond to the unique iSCSI Session opened on
that Operational target address.
The usage to configure the login values for the user configurable login keys is as follows:
# iscsiutil [iscsi-device-file] -t <login-key> <login-val-1> <login-val-2> ...<login-val-N> [-T <target-name>
[-I <ip-address>] [-P <tcp-port>] [-M <portal-grp-tag>]]
The order in which the login values are listed in this command defines the order in which the iSCSI
initiator proposes them to the target. The login keys and values are not case-sensitive.
The configurable login keys currently available are:
• HeaderDigest
A header digest that can be negotiated during iSCSI login. The list of parameters that the
HeaderDigest key can accept are:
None
A.1 Configuring iSCSI Login Keys 39