csmstat Command

Purpose

csmstat – Provides a snapshot of cluster node reachability, power status, and network interface status.

Syntax

csmstat [-h]

csmstat [-l] [-a] [-S] [-s select_string] [-d delimiter] [-n node_list] [-N nodegroups]

Description

The csmstat command gathers node reachability, power status and network interface status for one or more nodes and displays the output. The default ordering for output is by host name. If there are multiple hardware control points for a node, multiple HMCs for example, then the first hardware control point in the list is shown.
Note: This command does not currently support nodes on IntelliStation workstations.

Flags

-a
Displays attribute information for all nodes. This is the default.
-d
Specifies delimiter-formatted output using the specified delimiter – colons, for example. Use this flagoption to specify a delimiter of one or more characters. This flagoption cannot be used with the –a flagoption.
-h
Displays command usage.
-l
Returns LCD values for SP Nodes, p660 servers, and HMC-attached IBM® System p® servers. This flagoption cannot be used with the –d flagoption.
-n node_list
Specifies a comma or space-separated list of node names to display attribute information. Space-separated node names must be inside double quotes. For information about specifying node ranges, see the noderange man page.
-N nodegroups
Specifies a comma or space-separated list of node groups to display attribute information. Space-separated node groups must be inside double quotes.
-s
Specifies, by column headers, which columns to display. Hostname is displayed by default. Other values include HWControlPoint, LCDS, Network-Interfaces, Status, PowerStatus and all. This flagoption cannot be used with the –l flagoption.
–S
Sorts output first by hardware control point and then by host name.

Parameters

None.

Security

The command requires root access to the cluster management server and a user ID with access to the IBM.NodeHwCtrl resource class in the RMC ctrmc.acls ACL file.

This command could require a systemid file. For more information, see the systemid man page.

Exit Status

Hostname
Host name for management of the node. This value will be truncated to seventeen characters. The seventeenth character is a ~ to indicate that truncation was used.
HWControlPoint
Host name of the network adapter for the hardware control point. This value will be truncated to seventeen characters. The seventeenth character is a ~ to indicate that truncation was used.
Status
Indicates if the node is reachable on the network and if the RMC subsystem on the node can communicate with the RMC subsystem on the management server. The valid states are 0 (off), 1 (on) and 127 (unknown). The English representation will be used except when using a delimiter.
PowerStatus
Indicates the current power status of the node. The valid states are 0 (off), 1 (on), 127 (unknown), and 128 (hardware control not configured). The English representation will be used except when using a delimiter.
NetworkInterface
Contains the Name of the device and the OpState.
Name
The name of the network interface. For example, eth0 on Linux and en0 on AIX®. Switch Network interfaces are also shown.
OpState
Represents the current state of the network interface. The valid states are:
1
Online
2
Offline

Examples

  1. The following command returns information in the default format: 
    csmstat

-----------------------------------------------------------------------------
Hostname         HWControlPoint  Status  PowerStatus Network-Interfaces
-----------------------------------------------------------------------------
clsn10.pok.ibm.c~  /dev/tty2     off     off         unknown
clsn11.pok.ibm.c~  /dev/tty3     off     off         unknown
clsn12.pok.ibm.c~  /dev/tty4     unknown on          unknown
clsn13.pok.ibm.c~  /dev/tty4     unknown on          unknown
clsn14.pok.ibm.c~  /dev/tty4     unknown off         unknown
clsn15.pok.ibm.c~  /dev/tty4     unknown on          unknown
clsn16.pok.ibm.c~  /dev/tty4     unknown on          unknown
clsn17.pok.ibm.c~  /dev/tty4     unknown on          unknown
clsn18.pok.ibm.c~  /dev/tty4     on      off         en0-Online
  2. The following command returns information with the specified delimiter: 
    csmstat -d ::

clsn10.pok.ibm.com::/dev/tty2::0::0::unknown
clsn11.pok.ibm.com::/dev/tty3::0::0::unknown
clsn12.pok.ibm.com::/dev/tty4::127::1::unknown
clsn13.pok.ibm.com::/dev/tty4::127::1::unknown
clsn14.pok.ibm.com::/dev/tty4::127::0::unknown
clsn15.pok.ibm.com::/dev/tty4::127::1::unknown
clsn16.pok.ibm.com::/dev/tty4::127::1::unknown
clsn17.pok.ibm.com::/dev/tty4::127::1::unknown
clsn18.pok.ibm.com::/dev/tty4::1::0::en0-1::
  3. The following command returns information for the specified column headers: 
     csmstat -s Status,Network-Interfaces 

------------------------------------------------
Hostname          Status  Network-Interfaces
------------------------------------------------
clsn10.pok.ibm.c~ on      en0-Online ml0-Offline
clsn11.pok.ibm.c~ on      sn1-Online sn0-Online at2-Online at1-Online at0-Online
                          en1-Offline en0-Online ml0-Offline
clsn12.pok.ibm.c~ on      en0-Online en1-Offline ml0-Offline sn1-Online sn0-Online
clsn13.pok.ibm.c~ off     unknown
clsn14.pok.ibm.c~ on      en0-Online en1-Offline at0-Online at1-Online at2-Online
                          at3-Online sn1-Online sn0-Online ml0-Offline
clsn15.pok.ibm.c~ on      en0-Online en1-Offline at0-Online at1-Online at2-Online
                          at3-Online ml0-Offline sn1-Online sn0-Online
clsn16.pok.ibm.c~ unknown unknown

Location

/opt/csm/bin/csmstat