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:
The command displays the cluster information. The following example is typical:mmlscluster
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