Name Type Description Mandatory Default
iscsi_
chap_name
String The host's CHAP
name identifier
N [None]
iscsi_
chap_
secret
String Password of
initiator used to
authenticate to XIV
when CHAP is
enabled
N [None]
This command defines a host that will attach to the IBM XIV Storage System. The
name of the host must be unique in the system.
Note:
Use the Adding a Port to a Hostcommand to add port addresses to this host.
Specifying the cluster is optional.
The parameters iscsi_chap_name and iscsi_chap_secret must either be both
specified - or both left unspecified.
If the iscsi_chap_secret does not conform to the required secret length (96-128 bits)-
the command will fail.
The command checks whether the iscsi_chap_name and iscsi_chap secret are
unique. In case they are not, it displays an error message (but will not fail the
command).
The secret has to be between 96 bits and 128 bits. There are 3 ways to enter the
secret:
v Base64: requires to prefix the entry with 0b. each subsequent character entered is
treated as a 6 bit equivalent length
v Hex: requires to prefix the entry with 0x. each subsequent character entered is
treated as a 4 bit equivalent length
v String: requires no prefix (cannot be prefixed with 0b or 0x). Each character
entered is treated as a 8 bit equivalent length
Example:
host_define host=server1
Output:
Command executed successfully.
Access Control:
User Category Permission
Storage administrator Allowed
Storage integration administrator Allowed
Application administrator Disallowed
Security administrator Disallowed
12 IBM XIV Storage System User Manual