| Where allowed to run: All environments (*ALL) Threadsafe: Yes |
Parameters Examples Error messages |
The Add Cluster Node Entry (ADDCLUNODE) command is used to add a node to the membership list of an existing cluster.
If the START parameter is set to *NO, the node that is being added will have a status of New and Cluster Resource Services will not be started on that node. The Start Cluster Node (STRCLUNOD) command can be called from a program running on one of the active nodes in the cluster to start Cluster Resource Services on a node that does not have a status of Active.
If the START parameter on this command is set to *YES, Cluster Resource Services will be started on the node that is being added. If Cluster Resource Services is successfully started, the status for the added node will be set to Active. Successful completion of this command results in Cluster Resource Services jobs (QCSTCTL, QCSTCRGM, and a job for each cluster resource group object in the cluster) started as system jobs. If the Cluster Resource Services cannot be started, the status of the added node will be set to New.
During the activation of Cluster Resource Services, the allow add to cluster (ALWADDCLU) network attribute is checked to see whether the node being added should be part of the cluster and whether to validate the cluster request through the use of X.509 digital certificates. If validation is required, the requesting node and the node being added must have the following installed on the systems:
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CLUSTER | Cluster | Name | Required, Positional 1 |
| NODE | Node list | Element list | Required, Positional 2 |
| Element 1: Node identifier | Name | ||
| Element 2: IP address | Values (up to 2 repetitions): Character value | ||
| START | Start indicator | *YES, *NO | Optional |
| Top |
Specifies the cluster to which the node is being added.
This is a required parameter.
| Top |
Specifies information about the node which will be placed in the cluster membership list.
This is a required parameter.
Element 1: Node identifier
A name that uniquely identifies a node.
Element 2: IP address
The cluster interface address is an IP address that is used by Cluster Resource Services to communicate with other nodes in the cluster. A maximum of 2 interface addresses per node can be specified.
An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host portion of the address.
An IPv6 internet address must be a unicast address and must not contain an imbedded IPv4 address (compatibility or mapped). An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. The "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.
If the IP address is entered from the command line, the address must be enclosed in apostrophes.
| Top |
Specifies whether or not Cluster Resource Services is to be started on the node being added.
| Top |
ADDCLUNODE CLUSTER(MYCLUSTER) NODE(NODE1 ('2.5.35.117'))
START(*YES)
This command adds node NODE1 to the cluster MYCLUSTER. Node NODE1 is added to the cluster membership list and Cluster Resource Services is started on NODE1. Interface address 2.5.35.117 will be used by Cluster Resource Services to communicate with the new node.
ADDCLUNODE CLUSTER(MYCLUSTER)
NODE(NODE1 ('2001:0DB8:333:4444:5555:6666:7777:F888'))
START(*YES)
This command adds node NODE1 to the cluster MYCLUSTER. Node NODE1 is added to the cluster membership list and Cluster Resource Services is started on NODE1. Interface address 2001:0DB8:333:4444:5555:6666:7777:F888 will be used by Cluster Resource Services to communicate with the new node.
| Top |
*ESCAPE Messages
| Top |