Use the chhost command to change the
name or type of a host object. This 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 ] { [ -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 default is generic.
The tpgs parameter enables extra target-port
unit attentions. Refer to Lenovo Storage V series 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 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 right-most 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.
- -chapsecretchap_secret
- (Optional) Sets the Challenge Handshake Authentication Protocol
(CHAP) secret used to authenticate the host for Internet Small Computer
System Interface (iSCSI) I/O. This secret is shared between the host
and the cluster. The CHAP secret for each host can be listed 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 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
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 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 using the chhost command with either
the chapsecret or nochapsecret parameter.
An invocation example
chhost -name testhostlode -mask 111111101101 hostone
The resulting output:
No feedback
An invocation example
chhost -type openvms 0
The resulting output:
No feedback
An invocation example
chhost -site site1 host3
The
resulting output:
No feedback