RMVCRGNODE (Remove Cluster Resource Group Node Entry) Command Description

RMVCRGNODE Command syntax diagram

 

Purpose

The Remove Cluster Resource Group Node Entry (RMVCRGNODE) command is used to remove a node from the recovery domain of a cluster resource group. The node being removed does not need to be active in the cluster to be removed from the recovery domain. When the node is removed from the recovery domain, the cluster resource group object is deleted from that system. If the cluster resource group is active, the primary node may not be removed from the cluster resouce group. If the cluster resource group has no backup nodes, the primary node cannot be removed.

This command will do the following for all cluster resource group types:

• Set the cluster resource group status to Remove Node Pending.
• Call the exit program on all active nodes in the recovery domain with an action code of REMOVE NODE, if an exit program is specified for the cluster resource group.
• Reset the cluster resource group status to the value at the time the command was called, if the exit program completes successfully on all nodes.
• Set the cluster resource group status to Indoubt if the exit program fails on any node and the original state of the cluster resource group cannot be recovered.

This command will do the following for application cluster resource groups:

• If Cluster Resource Services configured the takeover IP address, it will be removed.

This command will do the following for device cluster resource groups:

• If the node being removed is the current primary node, ownership of the devices specified in the cluster resource group are switched from the current primary to the new primary if none of the configuration objects are varied on on the current primary. If any configuration objects are varied on, an error message is returned. In addition, the new primary node must be active. Devices are not varied on after the ownership is switched. The node which is to become the new primary must be active in the cluster.

Restrictions

1. This CL command cannot be called from a cluster resource group exit program.
2. Cluster Resource Services must be started on the node running the command.
3. The cluster resource group status must be other than active in order to remove the node that is currently the primary.
4. At least one backup node must exist in the recovery domain of the cluster resource group, if the primary node is removed.
5. At least node must remain active in the recovery domain of the cluster resource group after the successful completion of the remove operation.

 

Required Parameters

CLUSTER

Specifies the name of the cluster containing the cluster resource group.

cluster-name: Specify the name of the cluster.

CRG

Specifies the name of the cluster resource group that is to have a node removed from its recovery domain.

cluster-resource-group-name: Specify the name of the cluster resource group from which the node will be removed.

NODE

Specifies the name of the node that is to be removed from the recovery domain of the cluster resource group.

node-identifier: Specify the name of the node that is to be removed.

Example for RMVCRGNODE

 
RMVCRGNODE CLUSTER(MYCLUSTER) CRG(MYCRG) NODE(RCHCST03) 

This command removes node RCHCST03 from the recovery domain of cluster resource group MYCRG in cluster MYCLUSTER.

Error messages for RMVCRGNODE

*ESCAPE Messages

CPF0001

Error found on &1 command.