mmlslicense command

Displays information about the IBM Storage Scale node licensing designation or about disk and cluster capacity.

Synopsis

mmlslicense [-Y] [-L | --capacity [--formatted] | --licensed-usage|--ilmt-data]

Availability

Available on all IBM Storage Scale editions.

Description

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

For information on IBM Storage Scale license designation, See IBM Storage 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 [--formatted]

Displays disk and cluster size information.

--formatted: Inserts commas to separate groups of three numerals for readability.

--licensed-usage

Displays the names and sizes of the NSDs, the total size of all the NSDs, and the licensed capacity limit. See Example 4. This option is valid only in the IBM Storage Scale Developer Edition.

Note: The licensed capacity of the IBM Storage Scale Developer Edition is 12 TB (12,000,000,000,000 bytes) of storage. The mmcrnsd command calculates the size of the current NSDs plus the size of the proposed new NSDs and fails with an error message if the licensed capacity would be exceeded. For more information, see the mmcrnsd command.

--ilmt-data

Writes the software identify information such as the product edition and the product ID into the /var/adm/ras/ILMT_Data.slmtag. This information is used by the IBM® License Metric Tool (ILMT). The option also writes the DECIMAL_TERABYTE metric into the log file. This metric represents the terabytes of storage capacity, in decimal number, for all the NSDs in the Cluster.

This option must be used independently and not with any other option, including the -Y option. It is valid only in the following editions:

IBM Storage Scale Erasure Code Edition
IBM Storage Scale Data Management Edition
IBM Storage Scale Data Access Edition

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. The shell commands must be executed without the use of a password and must not produce any extraneous messages. For more information, see Requirements for administering a GPFS file system.

Examples

1. The following command displays summary information about the IBM Storage Scale licenses of the nodes in the cluster:

#mmlslicense 
Summary information 
---------------------
Number of nodes defined in the cluster:                          4
Number of nodes with server license designation:                 1 
Number of nodes with FPO license designation:                    0
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. The following command displays the types of IBM Storage Scale licenses that are associated with the nodes in the cluster:

#mmlslicense -L
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 FPO license designation:                    0
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. The following command displays information for capacity-based licensing:

#mmlslicense --capacity --formatted
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

4. The following command displays the names and sizes of the NSDs, the total size of all the NSDs, and the licensed capacity limit:

#mmlslicense --licensed-usage
 NSD Name                                         NSD Size (Bytes)
------------------------------------------------------------------
 de1_c35f1m4n09_sda                                299,439,751,168
 de1_c35f1m4n09_sdf                                 99,488,890,880
 de1_mmimport_test                                  73,284,976,640


 Developer Edition Summary:
 =================================================================
 Total NSD Licensed Limit (12 TB):      12,000,000,000,000 (Bytes)        
 Total NSD Size:                           472,213,618,688 (Bytes)

5. The following command displays disk capacities in an environment that contains both vdisks and physical disks:

# mmlslicense --capacity

 NSD Summary:
 ======================
  Total Number of NSDs:     40
  RG001LG001VS002:          53957623808 Bytes
  RG001LG002VS002:          53957623808 Bytes
  RG001LG003VS002:          53957623808 Bytes
  RG001LG004VS002:          53957623808 Bytes
  RG001LG005VS002:          53957623808 Bytes
  RG001LG006VS002:          53957623808 Bytes
  RG002LG001VS016:          16544432128 Bytes
  RG002LG002VS016:          16544432128 Bytes
  RG002LG003VS016:          16544432128 Bytes
  RG002LG004VS016:          16544432128 Bytes
  RG002LG005VS016:          16544432128 Bytes
  RG003LG001VS001:          2002248531968 Bytes
  RG003LG001VS004:          252160507904 Bytes
  RG003LG001VS007:          252160507904 Bytes
  RG003LG002VS001:          2002248531968 Bytes
  RG003LG002VS004:          252160507904 Bytes
  RG003LG002VS007:          252160507904 Bytes
  RG003LG003VS001:          2002248531968 Bytes
  RG003LG003VS004:          252160507904 Bytes
  RG003LG003VS007:          252160507904 Bytes
  RG003LG004VS001:          2002248531968 Bytes
  RG003LG004VS004:          252160507904 Bytes
  RG003LG004VS007:          252160507904 Bytes
  RG003LG005VS001:          2002248531968 Bytes
  RG003LG005VS004:          252160507904 Bytes
  RG003LG005VS007:          252160507904 Bytes
  RG003LG006VS001:          2002248531968 Bytes
  RG003LG006VS004:          252160507904 Bytes
  RG003LG006VS007:          252160507904 Bytes
  RG003LG006VS001:          2002248531968 Bytes
  RG003LG006VS004:          252160507904 Bytes
  RG003LG006VS007:          252160507904 Bytes
  RG003LG007VS001:          2002248531968 Bytes
  RG003LG007VS004:          252160507904 Bytes
  RG003LG007VS007:          252160507904 Bytes
  RG003LG008VS001:          2002248531968 Bytes
  RG003LG008VS007:          252160507904 Bytes
  sdb:                      2097152000 Bytes
  sdc:                      2097152000 Bytes
  sdd:                      2097152000 Bytes
  sde:                      2097152000 Bytes
  sdf:                      2097152000 Bytes
  sdg:                      2097152000 Bytes

 Cluster Summary:
 ======================
 Cluster Total Capacity:   20219446689792 Bytes

Location

/usr/lpp/mmfs/bin