[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 5
stoprpnode Command
Purpose
Brings one or more nodes offline to a peer domain.
Syntax
stoprpnode [-f] [-h] [-TV] node_name1 [node_name2...]
Description
The stoprpnode command brings an online node offline to a peer
domain. The peer domain is determined by the online peer domain where the
command is run. The command must be run from a node that is online to the
desired peer domain.
The -f flag must
be used to override a subsystem's rejection of the request to take a node
offline. A subsystem may reject the request if a node 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 node must be brought offline regardless of the resource
state.
If this command is used to bring more than one node offline by specifying
more than one node_name parameter, and the node that this command
is running on is in the list, it will be brought offline last.
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
- node_name1 [node_name2...]
- Specifies the peer domain node name of the node that is to be brought
offline to the peer domain. To list the peer domain node names, run the lsrpnode command.
Security
The user of the stoprpnode command needs write permission for
the IBM.PeerNode resource class on each node that is to be stopped
in 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.
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 to the peer domain. The
node to be brought offline must be reachable from the node on which the command
is run.
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 and nodeB are online to ApplDomain.
- To bring nodeB offline, run this command on nodeA:
stoprpnode nodeB
- To bring nodeB offline and force the offline request, run this
command on nodeA:
stoprpnode -f nodeB
Location
- /usr/sbin/rsct/bin/stoprpnode
- Contains the stoprpnode command
Files
The /etc/services file is modified.
Related Information
Commands: addrpnode, lsrpnode, preprpnode, rmrpnode, startrpnode
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]