chcluster

You can use the chcluster command to modify the attributes of an existing cluster. You can enter this command any time after a cluster has been created.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svctask -- -- chcluster -- --------------------------------->

>--+------------------------------------+-- -------------------->
   '- -clusterip -- cluster_ip_address -'

>--+------------------------------------+-- -------------------->
   '- -serviceip -- service_ip_address -'

>--+-------------------------+-- --+-----------------------+---->
   '- -name -- cluster_name -'     '- -admpwd -- password -'

>-- --+---------------------------+-- -------------------------->
      '- -servicepwd -- password -'

>--+--------------------------+-- ------------------------------>
   '- -gw -- default_gateway -'

>--+------------------------+-- -------------------------------->
   '- -mask -- subnet_mask -'

>--+--------------------------+-- --+----------------------+---->
   '- -speed -- fabric_speed -'     '- -alias -- id_alias -'

>-- --+---------------------------------------+----------------><
      '- -icatip -- icat_console_ip_address  -'

Parameters

-clusterip cluster_ip_address
Changes the cluster IP address. After the cluster IP address is changed, you lose the open shell connection to the cluster. You must reconnect with the newly specified IP address.
-serviceip service_ip_address
Changes the service IP address. This address is the address that must be used if the node has to be started after it has been expelled from the cluster.
-name cluster_name
Changes the name of the cluster.
-admpwd password
Changes the administrator password. This argument can be specified with or without the password. If the argument is not followed by a password, you will be prompted for the password. When you type the password in response to the prompt, the password will not be displayed.
-servicepwd password
Changes the service user password. This argument can be specified with or without the password. If the argument is not followed by a password, you will be prompted for the password. When you type the password in response to the prompt, the password will not be displayed.
-gw default_gateway
Changes the default gateway IP address of the cluster.
-mask subnet_mask
Changes the subnet mask of the cluster.
-speed fabric_speed
Specifies the speed of the fabric to which this cluster is attached. Valid values are 1 or 2 (Gb).
-alias id_alias
This alias does not change the basic ID for the cluster, but does influence the VDisk_UID of every vdiskhostmap, both existing and new. These objects appear to have been created for a cluster whose ID matches the alias.
-icatip icat_console_ip_address
Changes the IP address of the SAN Volume Controller Console used by this cluster. The format of this IP address must be a dotted decimal notation together with the port (for example, 255.255.255.255:8080).

Description

This command modifies either the IP addresses that are assigned to the cluster, the passwords that are assigned to the two user names, or both. Any of the arguments can be used either singly or in conjunction with any of the other arguments.

If the cluster IP address is changed, the open command-line shell closes during the processing of the command. You must reconnect to the new IP address.

The service IP address is not used until a node is expelled from the cluster. If this node cannot rejoin the cluster, you can bring the node up in service mode. In this mode, the node can be accessed as a stand-alone node using the service IP address.

In release 1.2.0 and above, the cluster name can also be modified using this command.

If you do not specify any of the options, the command does nothing. The options are not mutually exclusive.

The command can also be used to change the subnet mask, default gateway, fabric speed or id_alias.

Modifying a password: To change the administrator users password, issue the svtask chcluster -admpwd <password> command. To change the service users password, issue the svtask chcluster -servicepwd <password> command.

Note:Note: If you do not wish the password to be displayed as you enter the command line then you can omit the new password. The command line tool will then prompt you to enter and confirm the password without the password being displayed.

Modifying an IP address: List the IP address of the cluster, by issuing the svcinfo lscluster command. Modify the IP address, by issuing the svctask chcluster command.

Possible failures

Examples

An invocation example

svctask chcluster -clusterip 217.12.3.11