mmlscluster command

Displays the current configuration information for a GPFS™ cluster.

Synopsis

mmlscluster [--cnfs] [--ces] [--cloud-gateway]

Availability

Available on all IBM Spectrum Scale™ editions.

Description

Use the mmlscluster command to display the current configuration information for a GPFS cluster.

For the GPFS cluster, the mmlscluster command displays:

The cluster name
The cluster ID
GPFS UID domain
The remote shell command being used
The remote file copy command being used
The repository type (CCR or server-based)
The primary GPFS cluster configuration server (if server-based repository)
The secondary GPFS cluster configuration server (if server-based repository)
A list of nodes belonging the GPFS cluster

For each node, the command displays:

The node number assigned to the node by GPFS
GPFS daemon node interface name
Primary network IP address
GPFS administration node interface name
Designation, such as whether the node is any of the following:
- quorum node
- manager node
- snmp_collector node
- gateway node

Parameters

--cnfs: Displays information about clustered NFS.
--ces: Displays information about protocol nodes.
--cloud-gateway: Displays information about Transparent Cloud Tiering nodes.

Exit status

0: Successful completion.
nonzero: A failure has occurred.

Security

You must have root authority to run the mmlscluster 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 GPFS file system.

Examples

To display the current configuration information for the GPFS cluster, issue this command:

mmlscluster

The system displays information similar to:

GPFS cluster information
========================
  GPFS cluster name:         cluster1.kgn.ibm.com
  GPFS cluster id:           680681562214606028
  GPFS UID domain:           cluster1.kgn.ibm.com
  Remote shell command:      /usr/bin/ssh
  Remote file copy command:  /usr/bin/scp
  Repository type:           CCR

Node  Daemon node name     IP address    Admin node name     Designation
------------------------------------------------------------------------
 1   k164n04.kgn.ibm.com   89.116.68.68  k164n04.kgn.ibm.com  quorum
 2   k164n05.kgn.ibm.com   89.116.68.69  k164n05.kgn.ibm.com  quorum
 3   k164n06.kgn.ibm.com   89.116.68.70  k164sn06.kgn.ibm.com quorum-manager

To display the configuration information about the Transparent Cloud Tiering nodes, issue this command:

mmlscluster --cloud-gateway

The system displays output similar to this:

GPFS cluster information
========================
  GPFS cluster name:         c350f1u1b11
  GPFS cluster id:           9364209917238477017

 Node  Daemon node name              Cloud node type
--------------------------------------------------
   1   c350f1u1b11                    Cloud-Gateway
   2   c350f8u17.pk.labs.ibm.com      Cloud-Gateway
   3   c350f8u18.pk.labs.ibm.com      Cloud-Gateway

Location

/usr/lpp/mmfs/bin