ADDCRGNODE (Add Cluster Resource Group Node Entry)

ADDCRGNODE Command syntax diagram

 

Purpose

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. 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. This command causes the roles of all nodes to be updated in the preferred recovery domain and the current recovery domain.

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.

Restrictions

  1. To use this command have *IOSYSCFG authority.

  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. 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. 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 API 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.

 

Required Parameters

CLUSTER
Specifies the name of the cluster where the cluster resource group exists.

cluster-name: Specify the name of the cluster where the cluster resource group exists.

CRG
Specifies the name of the cluster resource group that will have the new node added to its recovery domain.

cluster-resource-group-name: Specify the name of the cluster resource group.

NODE
Specifies the node being added to the recovery domain of the cluster resource group specified. The node specified must be in the cluster and must be unique in the recovery domain of the cluster resource group specified.

node-identifier: Specify the name of the cluster node.

 

Optional Parameters

RCYDMN
Specifies the role of the node in the recovery domain of the cluster resource group.

Element 1: Node Role
Specifies what role the node will have in the recovery domain.

*BACKUP: The new node will be added as a backup node.

*PRIMARY: The new node will be added as the primary node. The cluster resource group must have a status of Inactive.

*REPLICATE: The new node will be added as a replicate node. Replicate nodes are not ordered.

Element 2: 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.

backup-sequence-number: Specify the backup sequence number.

Example for ADDCRGNODE 

ADDCRGNODE CLUSTER(MYCLUSTER) CRG(MYCRG) NODE(NODE1) ROLE(*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.

Error messages for ADDCRGNODE

*ESCAPE Messages

CPF0001
Error found on &1 command.