Use the chhostcluster to change the name, type, or site of a host cluster
object that is part of a host cluster.
Syntax
chhostcluster [ -name new_name ] [ -type new_type ] { [ -site new_site ] | [ -nosite ] } [ -force ] { hostcluster_id | hostcluster_name }
Parameters
- -namenew_name
- (Optional) Specifies a name for a host cluster object. The value must be an alphanumeric
string.
- -typenew_type
- (Optional) Changes the type of the all hosts in the host cluster. The values are:
- generic (the default)
- tpgs(when target port information changes, extra unit attentions are given to
the host)
- openvms
- adminlun (enables virtual volumes)
- hpux
- epps
- hide_secondary
- -sitenew_site
- (Optional) Changes the site for all hosts in the host cluster. The default is
site0 (meaning there is no site). The value must be an alphanumeric string.
- -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.)
Remember: Using the force parameter
might result in a loss of access. Use it only under the direction of your product support
information.
- hostcluster_id | hostcluster_name
- (Required) Specifies (by ID or name) 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,
note that the site and type properties 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 using the chhostcluster command to change the attribute values on every
host in the host cluster simultaneously (rather than modifying each host separately).
An invocation example that changes settings of host cluster
hostcluster0
chhostcluster -name myhostcluster hostcluster0
The detailed resulting output:
No feedback
An invocation example that changes site of every host in host cluster 2
The hosts are currently in site 0 or in site1.
chhostcluster -site site1 2
The detailed resulting output:
No feedback
An invocation example that changes name of hostcluster0
All host sites are set to site0, which is the default. One host is not
currently in site 0.
chhostcluster -name jvardy1 -nosite -force hostcluster0
The detailed resulting output:
No feedback