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