mmgetstate command
Displays the state of the GPFS™ daemon on one or more nodes.
Synopsis
mmgetstate [-L] [-s] [-v] [-a | -N {Node[,Node...] | NodeFile | NodeClass}]
Availability
Available on all IBM Spectrum Scale™ editions.
Description
Use the mmgetstate command to show the state of the GPFS daemon on one or more nodes.
Parameters
- -a
- Show the state of the GPFS daemon on all nodes in the cluster.
- -N {Node[,Node...] | NodeFile | NodeClass}
- Directs the mmgetstate command to return GPFS daemon information for a set
of nodes.
For general information on how to specify node names, see Specifying nodes as input to GPFS commands in the IBM Spectrum Scale: Administration and Programming Reference.
This command does not support a NodeClass of mount.
Options
- -L
- Display quorum, number of nodes up, total number of nodes, and other extended node information.
- -s
- Display summary information such as: number of local and remote nodes that have joined in the cluster, number of quorum nodes.
- -v
- Display intermediate error messages.
The GPFS states recognized and displayed by this command are:
- active
- GPFS is ready for operations.
- arbitrating
- A node is trying to form a quorum with the other available nodes.
- down
- GPFS daemon is not running on the node or is recovering from an internal error.
- unknown
- Unknown value. Node cannot be reached or some other error occurred.
Exit status
- 0
- Successful completion.
- nonzero
- A failure has occurred.
Security
You must have root authority to run the mmgetstate command.
The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For more information, see Requirements for administering a file system in IBM Spectrum Scale: Administration and Programming Reference.
Examples
- To display the quorum, the number of nodes up, and the total number
of nodes for the GPFS cluster,
issue:
mmgetstate -a -L
The system displays output similar to:Node number Node name Quorum Nodes up Total nodes GPFS state Remarks ---------------------------------------------------------------------------- 1 c5n92 3 5 12 active 2 c5n94 3 5 12 active 3 c5n95 3 5 12 active quorum node 4 c5n96 3 5 12 active 5 c5n97 3 5 12 active quorum node 6 c5n98 3 5 12 active 7 c5n107 3 5 12 active quorum node 8 c5n108 3 5 12 active 9 c5n109 3 5 12 active quorum node 10 c5n110 3 5 12 down 11 c5n111 3 5 12 active quorum node 12 c5n112 3 5 12 active
The 3 under the Quorum column means that you must have three quorum nodes up to achieve quorum.
- This is an example of a cluster using node quorum with tiebreaker
disks. Note the * in the Quorum field, which indicates that tiebreaker
disks are being used:
The system displays output similar to:mmgetstate -a -L
Node number Node name Quorum Nodes up Total nodes GPFS state Remarks ------------------------------------------------------------------------ 1 k5n91 5* 8 21 active 2 k5n92 5* 8 21 active quorum node 3 k5n94 5* 8 21 active 5 k5n96 5* 8 21 active 6 k5n97 5* 8 21 active quorum node 7 k5n98 5* 8 21 active 8 k5n99 5* 8 21 active quorum node
- To display summary information, issue this command:
The system displays output similar to:mmgetstate -s
Node number Node name GPFS state ------------------------------------------ 5 c5n97 active Summary information --------------------- Number of nodes defined in the cluster: 12 Number of local nodes active in the cluster: 12 Number of remote nodes joined in this cluster: 0 Number of quorum nodes defined in the cluster: 5 Number of quorum nodes active in the cluster: 5 Quorum = 3, Quorum achieved