chcluster

Parameters

-name cluster_name

(Optional) Specifies a new name for the cluster.

Important: The iSCSI Qualified Name (IQN) for each node is generated using the cluster and node names. If you are using the iSCSI protocol, changing either name also changes the IQN of all of the nodes in the cluster and might require reconfiguration of all iSCSI-attached hosts.

-servicepwd password

(Optional) Specifies a new service user password. You can specify this parameter with or without the password. If the parameter is not followed by a password, you are prompted for the password. When you type the password in response to the prompt, the password is not displayed.

Note: Only a user with administrator authority can change the password.

-speed fabric_speed

(Optional) Specifies the speed of the fabric to which this cluster is attached. Valid values are 1 or 2 (GB).

Attention: Changing the speed on a running cluster breaks I/O service to the attached hosts. Before changing the fabric speed, stop I/O from active hosts and force these hosts to flush any cached data by unmounting volumes (for UNIX® host types) or by removing drive letters (for Windows® host types). Some hosts might need to be rebooted to detect the new fabric speed.

The fabric speed setting applies only to the SAN Volume Controller model 2145-8F2 in a cluster. The SAN Volume Controller models 2145-8A4, 2145-CF8, 2145-8G4, and 2145-8F4 automatically negotiate the fabric speed on a per-port basis.

-alias id_alias

(Optional) Specifies an alternate name that 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. Therefore, changing the cluster alias causes loss of host VDisk access, until each host rescans for VDisks presented by the cluster.

-icatip icat_console_ip_address

(Optional) Specifies the new IP address that is used by the cluster. The format of this IP address must be a dotted decimal notation with the port; for example, 255.255.255.255:8080. If you specify this parameter, it overwrites any existing -icatip_6 address.

-invemailinterval interval

(Optional) Specifies the interval at which inventory e-mails are sent to the designated e-mail recipients. The interval range is 0 to 15. The interval is measured in days. Setting the value to 0 turns the inventory e-mail notification function off.

-gmlinktolerance link_tolerance

(Optional) Specifies the length of time, in seconds, for which an inadequate intercluster link is tolerated for a Global Mirror operation. The parameter accepts values from 60 to 400 seconds in steps of 10 seconds. The default is 300 seconds. You can disable the link tolerance by entering a value of zero (0) for this parameter.

-gminterdelaysimulation inter_cluster_delay_simulation

(Optional) Specifies the intercluster delay simulation, which simulates the Global Mirror round trip delay between two clusters, in milliseconds. The default is 0; the valid range is 0 to 100 milliseconds.

-gmintradelaysimulation intra_cluster_delay_simulation

(Optional) Specifies the intracluster delay simulation, which simulates the Global Mirror round trip delay in milliseconds. The default is 0; the valid range is 0 to 100 milliseconds.

-icatip_6 icat_console_ipv6_address

(Optional) Specifies the new IPv6 address that is used by the cluster. If you specify this parameter, it overwrites any existing -icatip address. The format of the IPv6 address must be one of the following:

• Eight colon-separated groups of four hexadecimal digits; for example:

  [1234:1234:abcd:0123:0000:0000:7689:6576]:23

• Eight colon-separated groups of hexadecimal digits with leading zeros omitted; for example:

  [1234:1234:abcd:123:0:0:7689:6576]:23

• Suppression of one or more consecutive all 0 groups; for example:

  [1234:1234:abcd:123::7689:6576]:23

-ntpip ipv4_ntp_ip_address

(Optional) Specifies the IPv4 address for the Network Time Protocol (NTP) server. Configuring an NTP server address causes the cluster to immediately start using that NTP server as its time source. To stop using the NTP server as a time source, invoke the -ntpip parameter with a zero address, as follows:

svctask chcluster -ntpip 0.0.0.0

-ntpip_6 ipv6_ntp_ip_address

(Optional) Specifies the IPv6 address for the NTP server. Configuring an NTP server address causes the cluster to immediately start using that NTP server as its time source. To stop using the NTP server as a time source, invoke the -ntpip_6 parameter with a zero address, as follows:

svctask chcluster -ntpip_6 0::0

-isns sns_server_address

(Optional) Specifies the IPv4 address for the iSCSI storage name service (SNS).

-isns_6 ipv6_sns_server_address

(Optional) Specifies the IPv6 address for the iSCSI SNS.

-relationshipbandwidthlimit bandwidth_in_mbps

(Optional) Specifies the new background copy bandwidth in megabytes per second (MBps), from 1 - 1000. The default is 25 MBps. This parameter operates cluster-wide and defines the maximum background copy bandwidth that any relationship can adopt. The existing background copy bandwidth settings defined on a partnership continue to operate, with the lower of the partnership and VDisk rates attempted.

Note: Do not set this value higher than the default without establishing that the higher bandwidth can be sustained.

-iscsiauthmethod none | chap

(Optional) Sets the authentication method for the iSCSI communications of the cluster. The iscsiauthmethod value can be none or chap.

-chapsecret chap_secret

(Optional) Sets the Challenge Handshake Authentication Protocol (CHAP) secret to be used to authenticate the cluster via iSCSI. This parameter is required if the iscsiauthmethod chap parameter is specified. The specified CHAP secret cannot begin or end with a space.

-nochapsecret

(Optional) Clears any previously set CHAP secret for iSCSI authentication. This parameter is not allowed if the chapsecret parameter is specified.