Use the chhost command to change the name or type of a host object.
This command does not affect any existing host mappings.
Syntax
chhost [ -type { hpux | tpgs | generic | openvms | adminlun | hide_secondary } ] [ -mask port_login_mask ] [ -name new_name_arg ] [ -iscsiusername username_for_authentication ] { [ -chapsecret chap_secret ] | [ -nochapsecret ] } { [ -site { site_name | site_id } ] | [ -nosite ] } { host_name | host_id }
Parameters
- -typehpux |tpgs|generic|openvms|adminlun|hide_secondary
- (Optional) Specifies the type of host. The following values are the available host types:
- generic indicates the default.
- tpgs indicates when target port information changes (extra unit
attentions are given to the host).
- openvms indicates OpenVMS.
- adminlun indicates virtual volumes, which are enabled on the host.
- hpux indicates HP-UX firmware.
- hide_secondary indicates that all remote copy relationship secondary
volumes are unavailable to the host.
For more information about hosts that require the type parameter,
see the Storwize V5000 host attachment
documentation.
- -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 a host can access and the Fibre Channel (FC)
port mask for the host. Worldwide port names (WWPNs) in the host object must access volumes
from the node ports that are included in the mask and are in the host object's I/O group. The
port mask is 64 binary bits and is made up of a combination of 0's and 1's, where
0 indicates that the corresponding FC I/O port cannot be used and
1 indicates that it can be used. The rightmost bit in the mask
corresponds to FC I/O port 1. Valid mask values might range from 0000
(no ports enabled) to
1111111111111111111111111111111111111111111111111111111111111111 (all
ports enabled). For example, a mask of 111111101101 enables ports 1, 3,
4, 6, 7, 8, 9, 10, 11, and 12.
- -iscsiusernameusername_for_authentication
- (Optional) Specifies the user name for a host object for one-way authentication for
Internet Small Computer System Interface (iSCSI) host attachment login. If this parameter is
specified, the value is taken as the "username" for one-way authentication to log in to the
iSCSI host attachment. If you do not specify the iscsiusername parameter,
the IQN of the host object is used as the user name by default. If no
iscsiusername parameter is provided and multiple IQNs exist in the same
host object, the user name of each IQN is the IQN itself. If the
iscsiusername parameter is provided for a multiple IQN host, then log
in to all hosts by using the provided IQN. If you use the
iscsiusername parameter, you must also specify the
chapsecret parameter.
- -chapsecretchap_secret
- (Optional) Sets the Challenge Handshake Authentication Protocol (CHAP) secret that is 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 by using the
lsiscsiauth command.
- -nochapsecret
- (Optional) Clears any previously set CHAP secret for this host. The
nochapsecret parameter cannot be specified if
chapsecret is specified.
- -sitesite_name | site_id
- (Optional) Specifies the numeric site value or site name of the host. The site name must be
an alphanumeric value. The site ID must be 1 or 2. The
site that is assigned to a host can be changed with any topology (hyperswap
or standard).
Note: If the host is mapped to a volume that is in an active relationship,
you cannot specify -nosite.
- -nosite
- (Optional) Resets the site value.
- 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 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 bus
adapter (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 whether access is allowed or is
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
lsiscsiauth command does not display the authentication entry for that host.
Use the addhostiogrp command to map the iSCSI host to at least one I/O group,
and then use the addhostport command to add the iSCSI port into it. You must
also add authentication for that host by using the chhost command with either
the chapsecret or nochapsecret
parameter.
An invocation
example
chhost -name testhostlode -mask 111111101101 hostone
The
following output is displayed:
No feedback
An invocation example
chhost -type openvms 0
The following output is displayed:
No feedback
An invocation
example
chhost -site site1 host3
The following output is
displayed:
No feedback