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