chhost

Use the chhost command to change the name or type of a host object. This command does not affect any existing host mappings.

Syntax

Parameters

(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.

The host type for NVMe hosts cannot be changed. For more information about hosts that require the type parameter, see the IBM Spectrum Virtualize host attachment documentation.

-name new_name_arg

(Optional) Specifies the new name that you want to assign to the host object.

-protocol scsi | nvme

(Optional) Specifies the protocol that is used by the host to communicate with the storage system. The default is scsi. The host -protocol cannot be changed at the same time as the host -type. The protocol of a host can be changed only if the following items are true:

No volumes are mapped to the host.
No ports are defined on the host.
The host type is compatible with the new protocol. A host that uses the NVMe protocol must be of type generic.

-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.

Attention: Changing the host port mask might result in a loss of access. Before you disable ports, check that the host has access to other ports.

-iscsiusername username_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.

-chapsecret chap_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.

-site site_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, stretched, or standard).

Note: If the host is mapped to a volume that is in an active-active relationship (HyperSwap®), you cannot specify -nosite.

-nosite

(Optional) Resets the site value.

-statuspolicy redundant | complete

(Optional) Specifies if complete or redundant policy is used for online status calculations.

Complete connectivity is where online host status indicates complete connectivity, with every host port that is logged in to every node through which that host can access volumes, and degraded host status indicates one or more of these nodes does not have a login.
Redundant connectivity calculation is where online host status indicates redundant connectivity, where enough host ports are logged in to enough nodes such that the removal of a single node or a single host port allows that host to access all of its volumes. In addition, there must be the same total login count from the host to each node within an I/O group. Degraded host status indicates non-redundant connectivity, in which a single point of failure prevents a host from accessing at least some of its volumes, or there is no single point of failure but the total login count from the host to each node within an I/O group is not the same.

The default value is redundant.

-statussite all | local

(Optional) Specifies whether all sites or only the local host site connectivity is used to determine online status. local is only applicable in a dual site topology for a host with a valid site. The default value is all.

-ownershipgroup owner_id | owner_name

(Optional) The name or ID of the ownership group to which the object is being added.

-noownershipgroup

(Optional) If specified, the object is removed from the ownership group to which it belongs.

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.

Note: If the host is contained within a host cluster, you cannot change the ownership. The host is observing the ownership of the host cluster.