mmlslicense command

Displays information about the GPFS™ node licensing designation or about disk and cluster capacity.

Synopsis

mmlslicense [-Y] [-L | --capacity [--formatted]]

Availability

Available on all IBM Spectrum Scale™ editions.

Description

Use the mmlslicense command to display the number of GPFS client, FPO, and server licenses assigned to the nodes in the cluster.

For information on IBM Spectrum Scale license designation, see IBM Spectrum Scale license designation.

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.
-L
Displays information about the license type that is associated with each of the nodes in the cluster. An asterisk after the license type indicates insufficient license level for the roles that the node performs.
--capacity
Displays disk and cluster size information.
--formatted
When --capacity is specified, inserts commas to separate groups of three numerals for readability.

Exit status

0
Successful completion.
nonzero
A failure occurred.

Security

You must have root authority to run the mmlslicense 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

1. To display the summary information about the type and number of GPFS licenses that are associated with the nodes in the cluster, enter the following command:
mmlslicense
The system displays information similar to the following example:
Summary information 
---------------------
Number of nodes defined in the cluster:                          4
Number of nodes with server license designation:                 1
Number of nodes with client license designation:                 2
Number of nodes still requiring server license designation:      1
Number of nodes still requiring client license designation:      1
This node runs IBM Spectrum Scale Advanced Edition
2. To display information about the type of GPFS licenses that are associated with each of the nodes in the cluster, enter the following command:
mmlslicense -L
The system displays information similar to the following example:
Node name                    Required license   Designated license
-------------------------------------------------------------------
k145n05.kgn.ibm.com               server            server
k145n06.kgn.ibm.com               server            client  *
k145n07.kgn.ibm.com               client            client
k145n08.kgn.ibm.com               client            none    *

 Summary information 
---------------------
Number of nodes defined in the cluster:                          4
Number of nodes with server license designation:                 1
Number of nodes with client license designation:                 2
Number of nodes still requiring server license designation:      1
Number of nodes still requiring client license designation:      1
This node runs IBM Spectrum Scale Advanced Edition
3. To display information for capacity-based licensing, enter the following command:
mmlslicense --capacity --formatted
The system displays information similar to the following example:
NSD Summary:
======================
Total Number of NSDs:  2
mynsd1:                            10,737,418,240 Bytes
mynsd2:                            10,737,418,240 Bytes

Cluster Summary:
======================
Cluster Total Capacity:   21,474,836,480 Bytes

See also

Location

/usr/lpp/mmfs/bin
Parent topic: Command reference