chhostcluster

Use the chhostcluster to change the name, type, or site of a host cluster object that is part of a host cluster.

Syntax

Read syntax diagramSkip visual syntax diagram chhostcluster -namenew_name-typegenerictpgsadminlunhpux-sitenew_site-nosite-force-draftpartitionpartition_namepartition_idpartition_uuid-ownershipgroupowner_nameowner_id-noownershipgroup-convertcommonmappings-uniformconnectivityyesnohostcluster_idhostcluster_namehostcluster_uuid

Parameters

-name new_name
(Optional) Specifies a name for a host cluster object. The value must be an alphanumeric string.
-type new_type
(Optional) Changes the type of the all hosts in the host cluster. The following values are available host types:
  • generic indicates the default.
  • tpgs indicates when target port information changes (deprecated).
  • openvms indicates OpenVMS (deprecated).
  • adminlun indicates virtual volumes, which are enabled on the host.
  • hpux indicates HP-UX firmware.
  • hide_secondary (deprecated).

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

-site new_site
(Optional) Changes the site for all hosts in the host cluster. The value must be an alphanumeric string and the default is site0 (meaning there is no site).
-nosite
(Optional) Resets the site value.
-force
(Optional) Specify this parameter to change the host cluster's site and also change a site for at least one host in that host cluster. You do not have to specify this parameter if you are changing site 0.
Important: Using the force parameter might result in a loss of access. Use it only under the direction of IBM® support personnel.
-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.
-draftpartition partition_id | partition_name| partition_uuid
(Optional) Specifies the name or ID or UUID of the draft partition to which the host cluster should be added.
Note: If the draft partition is being split from another storage partition, only host clusters that are associated with that source storage partition may be added to the split draft partition. If the split draft partition is published, these host clusters will be removed from the source storage partition at the time of publication.
-convertcommonmappings
(Optional) Convert all private mappings that have the same characteristics and are on all the hosts in the host cluster to shared mappings.
-uniformconnectivity yes | no
(Optional) Specifies if hosts in the host cluster are expected to have connectivity to both locations for a highly available storage partition. If uniformconnectivity is set to no, the host cluster will report an Online status when each host in that host cluster is only logged in to the system that matches the location set for that host. Value can be yes or no.
hostcluster_id | hostcluster_name| hostcluster_uuid
(Required) Specifies (by ID or name or by UUID) the host cluster object to change. The value for the ID must be a number and the value for the name must be an alphanumeric string.

Description

This command changes the name, type, or a site on a host cluster object.

If you assign a host to a site and it is not specified as site0, you must use -force to change it.
Important: Do not specify -site site0, instead use -nosite.

If you specify the -site and -type parameters, the site and type properties that are changed are not attributes of the host cluster object. They are properties of the individual hosts that are members of the host cluster. These properties can be modified by using the chhostcluster command to change the attribute values on every host in the host cluster simultaneously (rather than modifying each host separately).

Note: This command is available during the upgrade process.
When using the partition IP address to run this command, consider the following:
  • The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
  • Only objects belonging to the partition can be created or acted upon. When creating new objects, the -partition parameter will be auto-populated for the partition. You cannot move items out of a partition when using the partition IP address.

An invocation example that changes settings of host cluster hostcluster0

chhostcluster -name myhostcluster hostcluster0

The following detailed output is displayed:

No feedback