rmrpnode Command

Purpose

Removes one or more nodes from a peer domain definition.

Syntax

rmrpnode [-f] [-q] [-h] [-TV] node_name1 [node_name2 ...]

rmrpnode -F { file_name"–" } [-f] [-q] [-h] [-TV]

Description

The rmrpnode command removes one or more nodes from the online peer domain where the command is run. The command must be run on a node that is online to the peer domain in which the nodes are to be removed. The nodes that are to be removed must be offline to the peer domain and must be reachable from the node where the command is run. To take nodes offline, use the stoprpnode command.

If a Cluster-Aware AIX® (CAA) cluster is configured and this peer domain is representing it, the rmrpnode command removes the nodes from the underlying CAA cluster as well.

Specifying the -f flag forces the specified nodes to be removed from the peer domain. When the last tiebreaker node is removed using rmrpnode -f, only the remaining quorum nodes (as opposed to all nodes) are converted to being tiebreaker nodes.

If the -f flag is not specified when this command is run:
  • more than half of the quorum nodes must be online to remove one or more nodes from the domain
  • an error is returned if the peer domain has no remaining tiebreaker nodes as a result
See the Administering RSCT for more information about quorum nodes and tiebreaker nodes.

Flags

-f
Forces the specified nodes to be removed from the peer domain.

When the last tiebreaker node is removed using this flag, only the remaining quorum nodes (as opposed to all nodes) are converted to being tiebreaker nodes.

See the Administering RSCT for more information about quorum nodes and tiebreaker nodes.

-q
Specifies quiet mode. The command does not return an error if the specified nodes are not in the peer domain.
-F { file_name | "–" }
Reads a list of node names from file_name. Each line of the file is scanned for one node name. The pound sign (#) indicates that the remainder of the line (or the entire line if the # is in column 1) is a comment.

Use -F "-" to specify STDIN as the input file.

-h
Writes the command's usage statement to standard output.
-T
Writes the command's trace messages to standard error. For your software service organization's use only.
-V
Writes the command's verbose messages to standard output.

Parameters

node_name1 [node_name2 ...]
Specifies the peer domain node names of the nodes to be removed from the peer domain definition. You can remove one or more nodes using the rmrpnode command. You must specify the node names in exactly the same format as they were specified with the addrpnode command or the mkrpdomain command. To list the peer domain node names, run the lsrpnode command.

Security

The user of the rmrpnode command needs write permission for the IBM.PeerNode resource class on each node that is to be removed from the peer domain. By default, root on any node in the peer domain has read and write access to this resource class through the configuration resource manager.

Exit Status

0
The command ran successfully.
1
An error occurred with RMC.
2
An error occurred with a command-line interface script.
3
An incorrect flag was entered on the command line.
4
An incorrect parameter was entered on the command line.
5
An error occurred that was based on incorrect command-line input.
6
The node does not exist in the peer domain.

Environment Variables

CT_CONTACT
Determines the system where the session with the resource monitoring and control (RMC) daemon occurs. When CT_CONTACT is set to a host name or IP address, the command contacts the RMC daemon on the specified host. If CT_CONTACT is not set, the command contacts the RMC daemon on the local system where the command is being run. The target of the RMC daemon session and the management scope determine the resource classes or resources that are processed.
CT_IP_AUTHENT
When the CT_IP_AUTHENT environment variable exists, the RMC daemon uses IP-based network authentication to contact the RMC daemon on the system that is specified by the IP address to which the CT_CONTACT environment variable is set. CT_IP_AUTHENT only has meaning if CT_CONTACT is set to an IP address; it does not rely on the domain name system (DNS) service.

Restrictions

This command must be run on a node that is online in the peer domain in which the nodes are to be removed. The nodes to be removed must also be offline to the peer domain.

Implementation Specifics

This command is part of the rsct.basic.rte fileset for AIX®.

Standard Input

When the -F "-" flag is specified, this command reads one or more node names from standard input.

Standard Output

When the -h flag is specified, this command's usage statement is written to standard output. All verbose messages are written to standard output.

Standard Error

All trace messages are written to standard error.

Examples

To remove the peer domain definitions of nodes nodeB and nodeC from the peer domain ApplDomain, when nodeA is defined and online to ApplDomain, and nodeB and nodeC are reachable from nodeA, run this command from nodeA:
rmrpnode nodeB nodeC

Location

/usr/sbin/rsct/bin/rmrpnode