[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Commands Reference, Volume 3
lsrpnode Command
Purpose
Lists information about the nodes defined in a peer domain.
Syntax
lsrpnode [-o | -O | -L] [-l | -t | -d | -D delimiter] [-x] [-h] [-TV] [node_name]
lsrpnode [-l | -t | -d | -D delimiter] [-x] [-p domain_name] [-h] [-TV]
Description
The lsrpnode command lists information about the nodes that are
in the online peer domain. The flags and parameters can be used to specify what is listed. When a
node name is specified, the listed information is limited to that node's
information only. The -o or -O flag also limits the listed information. The -o flag lists only
the online nodes' information. The -O flag lists information only for nodes that are offline.
Some of the node information that is listed follows:
- Name
- Specifies the name of the node in the peer domain.
- OpState
- Specifies the state of the node.
- RSCTVersion
- Specifies the version of RSCT that is active in the node.
Flags
- -o
- Lists information about the online nodes in the peer domain.
- -O
- Lists information about nodes that are offline in the peer domain.
- -L
- Lists information about the local node only.
- -l
- Displays the information on separate lines (long format).
- -t
- Displays the information in separate columns (table format). This is
the default format.
- -d
- Displays the information using delimiters. The default delimiter is
a colon (:). Use the -D flag if you want to change the default delimiter.
- -D delimiter
- Displays the information using the specified delimiter. Use this flag to specify a delimiter
other than the default colon (:) -- when the information you
want to display contains colons, for example. You can use this flag to specify a delimiter of one or
more characters.
- -p domain_name
- Lists nodes that are defined in a different domain.
By default, the lsrpnode command lists the nodes that are defined in the domain on which
you are currently online.
You can use this flag to view nodes that are defined in an offline
domain. However, the list may not reflect changes after the node is taken
offline, because an offline node may not have the latest configuration.
- -x
- Excludes the header (suppresses header printing).
- -h
- Writes the command's usage statement to standard output.
- -T
- Writes the command's trace messages to standard error. For the IBM
Support Center's use only.
- -V
- Writes the command's verbose messages to standard output.
Parameters
- node_name
- Specifies the name of the node to be listed. node_name can
be a node name or a substring of a node name. When node_name is a
substring, any defined node name that contains the substring will be listed.
Security
The user of the lsrpnode command needs read permission for the IBM.PeerNode resource class on the node on which the command runs. 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 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
- To list general information about the nodes in the online peer domain
to which nodeA belongs, run this command on nodeA:
lsrpnode
The output will look like this:
Name OpState RSCTVersion
nodeA online 2.3.0.0
nodeB online 2.3.0.0
nodeC offline 2.3.0.0
- To list general information with the default delimiter and without the
heading about the nodes in the online peer domain to which nodeA belongs,
run this command on nodeA:
lsrpnode -xd
The output will
look like this:
nodeA:online:2.3.0.0:
nodeB:online:2.3.0.0:
nodeC:offline:2.3.0.0:
- To list in long form general information about the nodes in the online
peer domains to which nodeA belongs, run this command on nodeA:
lsrpnode -l
The output will look like this:
Name = nodeA
OpState = online
RSCTVersion = 2.3.0.0
Name = nodeB
OpState = online
RSCTVersion = 2.3.0.0
Name = nodeC
OpState = offline
RSCTVersion = 2.3.0.0
Location
- /usr/sbin/rsct/bin/lsrpnode
- Contains the lsrpnode command
Related Information
Commands: addrpnode, preprpnode, startrpnode, stoprpnode
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]