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
- 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
- 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::
- 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