mmlscluster command

Displays the current configuration information for a GPFS cluster.

Synopsis

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

Availability

Available on all IBM Spectrum Scale editions.

Description

Use the mmlscluster command to display the current configuration information for an IBM Spectrum Scale cluster.

For the IBM Spectrum Scale cluster, the mmlscluster command displays:

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

For each node, the command displays:

The node number assigned to the node by IBM Spectrum Scale
GPFS daemon node interface name
Primary network IP address
IBM Spectrum Scale administration node interface name
Designation, such as whether the node is any of the following:
- quorum node - A node in the cluster that is counted to determine if a quorum exists. Members of a cluster use the quorum node to determine if it is safe to continue I/O operations when a communications failure occurs.
- manager node - The file system node that provides the file system manager services to all of the nodes using the file system, including: file system configuration, disk space allocation, token management, and quota management.
- snmp_collector node - The designated SNMP collector node for the cluster. The GPFS SNMP subagent runs on the designated SNMP collector node. For additional information see GPFS SNMP support
- gateway node - Ensures primary and Disaster Recovery cluster communication during failover.
- perfmon node - Performance monitoring nodes collect metrics and performance information and sends the information to one or more performance collection nodes.

Parameters

-Y: Displays the command output in a parseable format with a colon (:) as a field delimiter. Each column is described by a header.
Note: Fields that have a colon (:) are encoded to prevent confusion. For the set of characters that might be encoded, see the command documentation of mmclidecode. Use the mmclidecode command to decode the field.

--ces: Displays information about protocol nodes.
--cnfs: Displays information about clustered NFS.
--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 the mmlscluster command with no parameters:

mmlscluster

The command displays the cluster information. The following example is typical:

GPFS cluster information
========================
  GPFS cluster name:         samplecluster.sample.com
  GPFS cluster id:           13953039421150668925
  GPFS UID domain:           samplecluster.sample.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  node1.sample.com     192.168.1.1    node1.sample.com      quorum-manager
   2  node2.sample.com     192.168.1.2    node2.sample.com      quorum-manager 
   3  node3.sample.com     192.168.1.3    node3.sample.com      quorum-manager 
   4  node4.sample.com     192.168.1.4    node4.sample.com        
   5  node5.sample.com     192.168.1.5    node4.sample.com
   6  node6.sample.com     192.168.1.6    node4.sample.com

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