Add Cluster Node Entry (ADDCLUNODE)

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:

• Operating System option 34 (Digital Certificate Manager)
• Cryptographic Access Provider Product (AC2 or AC3)

Restrictions:

• You must have input/output system configuration (*IOSYSCFG) special authority on all nodes in the cluster to run this command.
• This command cannot be called from a cluster resource group exit program.
• This command cannot be issued on the node being added. You must issue the command from a node in the cluster that has a status of Active. If Cluster Resource Services has not been started on any of the nodes in the cluster, you must issue this command from the node where the cluster was originally created, and the START parameter must be set to *NO.
• The node being added to the cluster must not already be a member of this or any other cluster. A node can be a member of only one cluster.
• If the START parameter is set to *YES, the node must be IP reachable (TCP/IP active and the INETD server started).
• The command will fail if any node in the cluster has a status of Partition.
• If the START parameter is set to *YES, the potential node version of the node being added must be equal to the current cluster version or up to one level higher than the current cluster version. The potential node version and the current cluster version can be retrieved by using the Display Cluster Information (DSPCLUINF) command.

Parameters

Cluster (CLUSTER)

Specifies the cluster to which the node is being added.

This is a required parameter.

name

Specify the name of the cluster to which the node is being added.

Node identifier (NODE)

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.

node-identifier

Specify a name for the system.

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.

character-value

Specify an IP address to be used to communicate with other nodes in the cluster. The IP addresses may be an IPv4 address (for any cluster version) or IPv6 address (if current cluster version is 7 or greater).

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.

Start indicator (START)

Specifies whether or not Cluster Resource Services is to be started on the node being added.

*YES

Cluster Resource Services will be started on the node.

*NO

Cluster Resource Services will not be started on any node.

Examples

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.

Error messages

*ESCAPE Messages

HAE000D

ADDCLUNODE command to add cluster node &1 in cluster &2 failed.