chhost

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