The chhost command changes the name or type of a host object. This does not affect any existing virtual disk-to-host mappings.
Syntax
>>- svctask -- -- chhost -- --+---------------------------+-----> '- -type --+- hpux ----+-- -' +- tpgs-----+ '- generic -' >--+--------------------------+-- ------------------------------> '- -mask - port_login_mask ' >--+-------------------------+-- -------------------------------> '- -name -- new_name_arg -' >--+-----------------------------+--+----------------+----------> '- -chapsecret-- chap_secret -' '- -nochapsecret-' >--+- host_name -+--------------------------------------------->< '- host_id ---'
Parameters
- -type hpux | tpgs | generic
- (Optional) Specifies the type of host: hpux, tpgs, or generic. The default is generic. The tpgs parameter enables extra target port unit attentions. Refer to SAN Volume Controller host attachment documentation for more information on the hosts that require the type parameter.
- -name new_name_arg
- (Optional) Specifies the new name that you want to assign to the host object.
- -mask port_login_mask
- (Optional) Specifies which node target ports that a host can access. The port mask is four binary bits and is made of a combination of 0's and 1's, where 0 indicates that the corresponding target port cannot be used and 1 indicates that it can be used. The right-most bit in the mask corresponds to the lowest numbered target port (1 not 4) on a node. Valid mask values range from 0000 (no ports enabled) to 1111 (all ports enabled). For example, a mask of 0011 enables port 1 and port 2. The default value is 1111 (all ports enabled).
- -chapsecret chap_secret
- (Optional) Sets the Challenge Handshake Authentication Protocol (CHAP) secret used to authenticate the host for iSCSI I/O. This secret is shared between the host and the cluster. The CHAP secret for each host can be listed using the svcinfo lsiscsiauth command.
- -nochapsecret
- (Optional) Clears any previously set CHAP secret for this host.
- host_name | host_id
- (Required) Specifies the host object to modify, either by ID or by current name.
Description
This command can change the name of the specified host to a new name, or it can change the type of host. This command does not affect any of the current virtual disk-to-host mappings.
The port mask applies to logins from the host initiator port that are associated with the host object. For each login between a host HBA port and node port, the node examines the port mask that is associated with the host object for which the host HBA is a member and determines if access is allowed or denied. If access is denied, the node responds to SCSI commands as if the HBA port is unknown.
Note: When all I/O groups are removed from an iSCSI host, the svcinfo
lsiscsiauth command does not display the authentication
entry for that host. Use the svctask addhostiogrp command
to map the iSCSI host to at least one I/O group, and then use the svctask
addhostport command to add the iSCSI port into it. You must
also add authentication for that host using the svctask chhost command
with either the chapsecret or nochapsecret parameter.
An invocation example
svctask chhost -name testhostlode -mask 0011 hostone
The resulting output
No feedback