Add CRG Node Entry (ADDCRGNODE)

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:

You must have input/output system configuration (*IOSYSCFG) special authority to run this command.
This command cannot be called from a cluster resource group exit program.
The node being added to the recovery domain must not already be a member of this cluster resource group's recovery domain.
For primary-backup model cluster resource groups, to add a node as the primary the cluster resource group must be Inactive.
Cluster Resource Services must be active on the node processing the request.
There must be at least one active node in the recovery domain.
The node being added must be active in the cluster.
The cluster resource group exit program must exist on each node in the recovery domain, including the node being added.
The node being added must be unique in the recovery domain of the cluster resource group specified.
If a node is being added to a resilient device cluster resource group:
1. 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.
2. The node must be in the same device domain as the other nodes in the recovery domain.
3. 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.
4. 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.
5. 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.
6. 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.

Keyword	Description	Choices	Notes
CLUSTER	Cluster	Name	Required, Positional 1
CRG	Cluster resource group	Name	Required, Positional 2
RCYDMN	Recovery domain node list	Element list	Required, Positional 3
Element 1: Node identifier	Name
Element 2: Node role	CRGTYPE, PRIMARY, BACKUP, REPLICATE, *PEER
Element 3: Backup sequence number	1-127, *LAST
Element 4: Site name	Name, *NONE
Element 5: Data port IP address	Single values: NONE Other values (up to 4 repetitions): Character value*

Recovery domain node list (RCYDMN)

Specifies the node and role for the node being added to the recovery domain of the cluster resource group specified for the Cluster resource group (CRG) parameter.

This is a required parameter.

Element 1: Node identifier

Specifies the node being added.

name: Specify the name of the cluster node.

Element 2: Node role

Specifies the role the node being added is to have in the recovery domain of the cluster resource group specified. For primary-backup model cluster resource groups a node can have one of three roles: primary, backup, or replicate. For peer model cluster resource groups a node can have one of two roles: peer or replicate. Any number of nodes can be designated as a peer or replicate. The following summarizes the valid values for the node being added:

*CRGTYPE: The node role will be set based on the type of the cluster resource group. If the type of cluster resource group is *PEER the default for the node role will be *PEER. For any other type of cluster resource group the default will be *BACKUP.
*PRIMARY: The new node will be added as the primary node. The cluster resource group must have a status of Inactive.
*BACKUP: The new node will be added as a backup node.
*REPLICATE: The new node will be added as a replicate. Replicates are not ordered and cannot become an access point unless changed to a proper role for the given cluster resource group type.
*PEER: The new node will be added as a peer. Peer nodes are not ordered and can become an active access point for the cluster resources.

Element 3: Backup sequence number

Specifies the backup order for a node with role of *BACKUP. If there is already a node with the same backup order, the new node is inserted in the position requested. At the completion of the request, the nodes with backup roles will be sequentially renumbered from the first backup to the last. The first backup will always be 1.

*LAST: The new node will be added as the last backup in the recovery domain.
1-127: Specify the backup sequence number to be used.

Element 4: Site name

Specifies the site name of the recovery domain node. This is valid only for a device cluster resource group, specifically for geographic mirroring. A site contains a subset of recovery domain nodes in the same physical location. All nodes at a site have access to the same copy of auxiliary storage pool.

*NONE: The recovery domain node does not have a site name.
name: Specify the site name for a recovery domain node.

Element 5: Data port IP address

Specifies the data port IP address for the recovery domain node. This is valid only for a device cluster resource group, specifically for geographic mirroring. The data port IP address is used to to send updates from a source node that owns the production copy of auxiliary storage pool to a target node that owns the mirror copy of auxiliary storage pool.

Single values

*NONE: The recovery domain node does not have a data port IP address.

Other values (up to 4 repetitions)

character-value: Specify the data port IP address for the recovery domain node.

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.