Commands Reference, Volume 4

rmrpdomain Command

Purpose

Removes a peer domain that has already been defined.

Syntax

rmrpdomain [-f] [-q] [-h] [-TV] domain_name

Description

The rmrpdomain command removes the peer domain definition specified by the domain_name parameter. The peer domain must already be defined to be removed. The command must be run on a node that is defined in the peer domain. When run on a node that is online to the peer domain and peer domain quorum exists, the rmrpdomain command removes the peer domain definition on all nodes defined to the peer domain that are reachable from that node. If a node that is defined to the peer domain is not reachable, that nodes local peer domain definition is not removed. To remove the local peer domain definition when the peer domain is not online or when the node is not online to the peer domain, run the rmrpdomain command on that node and specify the -f flag.

The most efficient way to remove a peer domain definition is to make sure the peer domain is online. Then, from a node that is online to the peer domain, run the rmrpdomain command. If there are nodes that are not reachable from the node on which the rmrpdomain command was run, on each of those nodes, run the rmrpdomain command using the -f flag. This can be done at a later time if the node itself is not operational.

The -f flag must also be used to override a subsystem's rejection of the peer domain removal. A subsystem may reject the request if a peer domain resource is busy, for example. Specifying the -f flag in this situation indicates to the subsystems that the peer domain definition must be removed. The -f flag does not override the lack of peer domain quorum. An online peer domain cannot be removed if peer domain quorum does not exist.

More than half of the nodes must be online to remove a peer domain.

Flags

-f

Forces the peer domain to be removed. The force flag is required to remove a peer domain definition:

from the local node when the node is not online to the peer domain.
when a subsystem may reject the request, as when resources are allocated, for example.

-q

Specifies quiet mode. The command does not return an error if the peer domain does not exist.

-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

domain_name: Specifies the name of the defined peer domain that is to be removed.

Security

The user of the rmrpdomain command needs write permission to the IBM.PeerDomain resource class on each node that is to be defined to 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 peer domain definition does not exist.

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.

Restrictions

The node on which this command is run must be defined to the peer domain and should be able to reach all of the nodes that are defined to the peer domain. The node's local peer domain definition will not be removed if the node is not reachable.

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 definition of ApplDomain where nodeA, nodeB, and nodeC are defined and online to ApplDomain, and all are reachable to each other, run this command on nodeA, nodeB,or nodeC:
```
rmrpdomain ApplDomain
```
To remove the local peer domain definition of ApplDomain on nodeD when nodeD is not online to the peer domain, the peer domain is offline, or the peer domain does not exist, run this command on nodeD:
```
rmrpdomain -f ApplDomain
```
To remove the peer domain definition of ApplDomain where nodeA, nodeB, and nodeC are defined and online to ApplDomain, all are reachable to each other, and to prevent a subsystem from rejecting the request, run this command on nodeA, nodeB, or nodeC:
```
rmrpdomain -f ApplDomain
```

Location

/usr/sbin/rsct/bin/rmrpdomain: Contains the rmrpdomain command

Files

The /etc/services file is modified.

Related Information

Commands: addrpnode, lsrpdomain, lsrpnode, mkrpdomain, preprpnode, rmrpnode, startrpdomain, stoprpdomain