Completion Codes:
v HOST_BAD_NAME
Host name does not exist
v HOST_NAME_EXISTS
Host name already exists
Updating a Host Definition
Updates a host definition.
host_update host=HostName [ iscsi_chap_name=iscsiChapName ] [ iscsi_chap_secret=iscaiPass ]
Parameters:
Name Type Description Mandatory Default
host Object name Name that
represents the host
to XIV
Y N/A
iscsi_
chap_name
String The host's CHAP
name identifier
N [unchanged]
iscsi_
chap_
secret
String Password of
initiator used to
authenticate to XIV
when CHAP is
enabled
N [unchanged]
This command updates the host definition. The command carries out the following
CHAP-related checks:
v The parameters iscsi_chap_name and iscsi_chap_secret must either be both
specified - or both left unspecified.These parameters have to be unique. In case
they are not, an error message is presented to the user, but the command won't
fail.
v The Secret needs to be between 96 bits and 128 bits. There are 3 ways to enter
the secret:
– Base64: requires to prefix the entry with 0b. each subsequent character
entered is treated as a 6 bit equivalent length
– Hex: requires to prefix the entry with 0x. each subsequent character entered is
treated as a 4 bit equivalent length
– String: requires no prefix (cannot be prefixed with 0b or 0x). Each character
entered is treated as a 8 bit equivalent length
v If the iscsi_chap_secret does not conform to the required secret length (96-128
bits)- the command will fail.
Changing the chap_name and/or chap_secret:
v A warning message will be presented stating that the changes will apply only on
the next time the host is connected.
Example:
host_update host iscsi_chap_name iscsi_chap_secret
18 IBM XIV Storage System User Manual
To Next Page
Loading...
