[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 5
stoprpdomain Command
Purpose
Brings an online peer domain offline.
Syntax
stoprpdomain [-f] [-h] [-TV] domain_name
Description
The stoprpdomain command brings all the nodes which are currently
online in the peer domain offline. The peer domain definition is not removed
from the nodes.
The command must be run on a node that is online in the peer domain. If
the command is run on a node that is offline to the peer domain, no action
is performed.
The -f flag must
be used to override a subsystems rejection of the request to take the peer
domain offline. A subsystem may reject the request if a peer domain resource
is busy, such as in the case of a shared disk. Specifying the -f flag in this situation indicates
to the subsystems that the peer domain must be brought offline regardless
of the resource state.
Flags
- -f
- Forces the subsystems to accept the stop request when it otherwise would
not.
- -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 online peer domain that is to be brought offline.
Security
The user of the stoprpdomain command needs write permission for
the IBM.PeerDomain resource class on each node that is 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
This command must be run on a node that is online in the peer domain.
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
In these examples, nodeA is one of the nodes defined and is online
to ApplDomain.
- To bring ApplDomain offline, run this command on nodeA:
stoprpdomain ApplDomain
- To bring ApplDomain offline while making sure the stop request
will not be rejected by any subsystem, run this command on nodeA:
stoprpdomain -f ApplDomain
Location
- /usr/sbin/rsct/bin/stoprpdomain
- Contains the stoprpdomain command
Files
The /etc/services file is modified.
Related Information
Commands: lsrpdomain, lsrpnode, mkrpdomain, preprpnode, startrpdomain
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]