La commande 'lsrpnode affiche les informations d'un ou plusieurs noeuds d'un domaine actif.
Ci-dessous la documentation officielle AIX V7.1 sur cette commande :
lsrpnode Command
Purpose
Displays information about one or more of the nodes that are defined in the online peer domain.
Syntax
lsrpnode [ [ -i ] [ -l | -t | -d | -D delimiter ] -o | -O | -L ] -P ] -Q ] [ -B ] [ -x ] [-h] [-TV] [node_name]
lsrpnode -p peer_domain [ -l -t -d -D delimiter ] [-x] [-h] [-TV]
Description
The lsrpnode command displays information about one or more of the nodes that are defined in the online peer domain. Use
the command's flags and parameters to specify which information you want to display and how you want to display it. When
you specify a node name, the command displays information about that node only.
The -o, -O, and -L flags also limit the information this command displays. The -o flag displays information about nodes
that are online. The -O flag displays information about nodes that are offline. The -L flag displays information about
the local node, which is the node the command runs on.
The -P flag displays additional node configuration information related to group services group leader selection. The -Q
flag displays additional node configuration information related to quorum decisions. The -B flag displays additional node
configuration information related to the tiebreaker mechanism.
By default, the lsrpnode command displays information in table format (-t).
Some of the node information that is displayed follows:
Field
Description
Name
The name of the node in the peer domain.
OpState
The operational state of the node.
RSCTVersion
The version of RSCT that is active in the node.
The following fields are displayed when you specify the -i flag:
Field
Description
NodeNum
The node number used by topology services and group services. This number is unique within the cluster.
NodeID
The unique node identifier. Along with other fields (depending on the flags specified), this field is displayed
when you specify the -P flag:
Field
Description
Preferred
Indicates whether the node is a group services group leader candidate. Along with other fields (depending on the
flags specified), this field is displayed when you specify the -Q flag:
Field
Description
Quorum
Indicates whether the node participates in quorum decisions. Along with other fields (depending on the flags
specified), this field is displayed when you specify the -B flag:
Field
Description
Tiebreaker
Indicates whether the node has access to the peer domain's tiebreaker mechanism. See the Administering RSCT guide
for information about group services group leader selection, quorum decisions, and the tiebreaker mechanism.
Flags
-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.
-i
Displays the node number and node ID for the node. The node number is used by topology services and group services
and is unique within the cluster. The node ID is the unique node identifier.
-l
Displays the information on separate lines (long format).
-L
Displays information about the local node only, which is the node that the command runs on.
-o
Displays information about the nodes that are online in the peer domain.
-O
Displays information about the nodes that are offline in the peer domain.
-p peer_domain
Displays information about nodes defined in an offline peer domain that the local node belongs to. (By default, the
lsrpnode command displays information about the nodes that are defined in the domain where you are currently
online.) However, this information might not reflect changes that are made to the domain after the local node is
taken offline, because an offline node might not have the latest configuration.
The -p flag ignores the CT_CONTACT environment variable. You must have root access to use the -p flag.
-P
Indicates whether the node is a group services group leader candidate. yes is displayed if the node can be a group
services group leader. no is displayed if the node cannot be a group services group leader. See the Administering
RSCT for more information about group services group leader selection.
-Q
Indicates whether the node participates in quorum decisions. yes is displayed if the node participates in quorum
decisions. no is displayed if the node does not participate in quorum decisions. See the Administering RSCT for more
information on quorum decisions.
-B
Indicates whether the node has access to the peer domain's tiebreaker mechanism. yes is displayed if the node has
access to the peer domain's tiebreaker mechanism. no is displayed if the node does not have access to the peer
domain's tiebreaker mechanism. See the Administering RSCT for more information on the tiebreaker mechanism.
-t
Displays the information in separate columns (table format). This is the default format.
-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 your software service organization's use only.
-V
Writes the command's verbose messages to standard output.
Parameters
node_name
Specifies the name of the node about which you want to display information. You can specify a node name or a
substring of a node name for this parameter. If you specify a substring, the command displays information about any
defined node with a name that contains the substring.
Security
The user of the lsrpnode command needs read permission for the IBM.PeerNode resource class on the node this command runs
on. 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.
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.
Implementation Specifics
This command is part of the Reliable Scalable Cluster Technology (RSCT) fileset for AIX .
Standard Input
When the -f "-" or -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
1 To display general information about the nodes in the online peer domain that nodeA belongs to, run this command on
nodeA:
lsrpnode
The output will look like this:
Name OpState RSCTVersion
nodeA Online 3.1.4.0
nodeB Online 3.1.4.0
nodeC Offline 3.1.4.0
2 To display general information about the nodes in the online peer domain that nodeA belongs to, with the default
delimiter (but without the heading), run this command on nodeA:
lsrpnode -xd
The output will look like this:
nodeA:Online:3.1.4.0:
nodeB:Online:3.1.4.0:
nodeC:Offline:3.1.4.0:
3 To display general information about the nodes in the online peer domain that nodeA belongs to, in long format, run
this command on nodeA:
lsrpnode -l
The output will look like this:
Name = nodeA
OpState = Online
RSCTVersion = 3.1.4.0
Name = nodeB
OpState = Online
RSCTVersion = 3.1.4.0
Name = nodeC
OpState = Offline
RSCTVersion = 3.1.4.0
4 To display general information about the nodes in the online peer domain that nodeA belongs to, including the node
number and node ID, run this command on nodeA:
lsrpnode -i
The output will look like this:
Name OpState RSCTVersion NodeNum NodeID
nodeA Online 3.1.4.0 2 40a514bed9d82412
nodeB Online 3.1.4.0 1 47fe57098f4ec4d9
5 To display general information about the nodes in the online peer domain to which nodeA belongs, including the
preferred group services group leader information, run this command on nodeA:
lsrpnode -P
The output will look like this:
Name OpState RSCTVersion Preferred
nodeA Online 3.1.4.0 yes
nodeB Online 3.1.4.0 no
6 To display general information about the nodes in the online peer domain to which nodeA belongs, including the
quorum information, run this command on nodeA:
lsrpnode -Q
The output will look like this:
Name OpState RSCTVersion Quorum
nodeA Online 3.1.4.0 no
nodeB Online 3.1.4.0 yes
nodeC Online 3.1.4.0 yes
7 To display general information about the nodes in the online peer domain to which nodeA belongs, including quorum
and tiebreaker information, run this command on nodeA:
lsrpnode -QB
The output will look like this:
Name OpState RSCTVersion Quorum Tiebreaker
nodeA Online 3.1.4.0 no no
nodeB Online 3.1.4.0 yes yes
nodeC Online 3.1.4.0 yes yes
Location
/usr/sbin/rsct/bin/lsrpnode
