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