CL Command Reference - ADDCRGNODE
CL Command List > ADDCRGNODE Reference
Description:
The Add Cluster Resource Group Node Entry (ADDCRGNODE) command is used to add a new node to the recovery domain of an existing cluster resource group. This command results in the preferred recovery domain and the current recovery domain being updated.
For primary-backup model cluster resource groups, the node can be added as another backup node, as a replicate node, or as the new primary node in the cluster resource group¡¯s recovery domain. A node can only be added as a primary node if the cluster resource group has a status of Inactive. When a new node is added as the primary, the old primary node becomes the last backup. If the cluster resource group has a status of Active, a node can be added as either a backup or a replicate.
For peer model cluster resource groups, the node can be added as a peer node or a replicate node. If the cluster resource group has a status of Active (10) and a peer node is added, the node will be added as an active access point.
A node can be added to a resilient device cluster resource group even if it has no device entries. Device entries must be added using the Add Cluster Resource Group Device Entry (ADDCRGDEVE) command before the cluster resource group can be started. If the node being added to a device cluster resource group is to become the new primary node, ownership of the devices specified are switched from the current primary to the new primary if none of the devices are varied on for the current primary. If any devices are varied on, an error message is returned. Devices are not varied on after the ownership is switched.
If a node is being added to a resilient device cluster resource group recovery domain with a site name and data port IP address, the node will be added to the recovery domain and then the QcstChangeClusterResourceGroup API will be used to add the site name and data port IP address to the node. If there is a failure due to the QcstChangeClusterResourceGroup call, then the node will be removed from the recovery domain.
Restrictions:
1. You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
2. This command cannot be called from a cluster resource group exit program.
3. The node being added to the recovery domain must not already be a member of this cluster resource group¡¯s recovery domain.
4. For primary-backup model cluster resource groups, to add a node as the primary the cluster resource group must be Inactive.
5. Cluster Resource Services must be active on the node processing the request.
6. There must be at least one active node in the recovery domain.
7. The node being added must be active in the cluster.
8. The cluster resource group exit program must exist on each node in the recovery domain, including the node being added.
9. The node being added must be unique in the recovery domain of the cluster resource group specified.
10. If a node is being added to a resilient device cluster resource group:
a. A node can be added to a cluster resource group even if it has no device entries. Device entries must be added using the Add Cluster Resource Group Device Entry (ADDCRGDEVE) command before the cluster resource group can be started.
b. The node must be in the same device domain as the other nodes in the recovery domain.
c. The configuration objects for the device resources in the cluster resource group must exist on the node being added and the resource names in the configuration objects must be the same as the resource names used by the configuration objects on the existing nodes in the recovery domain. The node being added must be able to access the hardware resources represented by the configuration objects in the cluster resource group.
d. If a data base name is specified in the configuration objects in the cluster resource group, it must be the same on the node being added.
e. All members of an auxiliary storage pool group must be configured in the cluster resource group before ownership of the auxiliary storage pool can be changed.
f. If a server takeover IP address is specified in the cluster resource group and the cluster resource group is active, the server takeover IP address must exist.
Examples:
Example 1: Adding a Backup Node to a CRG Recovery Domain
ADDCRGNODE CLUSTER(MYCLUSTER) CRG(MYCRG) RCYDMN(NODE1 *BACKUP 3)
This command adds node NODE1 to the recovery domain of cluster resource group MYCRG in the cluster called MYCLUSTER. The node is added as the third backup node. Any existing backup nodes will be renumbered sequentially.
Example 2: Adding a Node with Multiple Dataport IP Addresses
ADDCRGNODE CLUSTER(MYCLUSTER) CRG(MYCRG)
RCYDMN(NODE1 *BACKUP *LAST MYSITE (¡¯1.1.1.1¡¯ ¡¯2.2.2.2¡¯))
This command adds node NODE1 to the recovery domain of cluster resource group MYCRG in the cluster called MYCLUSTER. The node is added as the last backup node in the site MYSITE with 2 data port IP addresses.