mmlsvdisk command

Lists information for one or more IBM Storage Scale RAID vdisks.

Synopsis

mmlsvdisk [ --vdisk "VdiskName[;VdiskName...]" | --non-nsd ]

or


mmlsvdisk --recovery-group RecoveryGroupName [ --declustered-array DeclusteredArrayName ]

Availability

Available on all IBM Storage Scale editions.

Description

The mmlsvdisk command lists information for one or more vdisks, specified various ways. Unless the --recovery-group option is specified, the information comes from the GPFS cluster configuration data.

Parameters

--vdisk "VdiskName[;VdiskName...]"
Specifies the name or names of the vdisk or vdisks for which the information is to be listed.
--non-nsd
Indicates that information is to be listed for the vdisks that are not associated with NSDs.
--recovery-group RecoveryGroupName
Specifies the name of the recovery group.
Note: The specified recovery group must be active to run this command.
--declustered-array DeclusteredArrayName
Specifies the name of the declustered array.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmlsvdisk 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 additional details, see the following IBM Storage Scale RAID: Administration topic: Requirements for administering IBM Storage Scale RAID.

Examples

  1. The following command example shows how to list all vdisks in the GPFS cluster:
    mmlsvdisk
    

    The system displays output similar to the following:

                                                              declustered  block size
     vdisk name          RAID code        recovery group         array       in KiB    remarks
     ------------------  ---------------  ------------------  -----------  ----------  -------
     000DE37BOTDA1DATA   8+3p             000DE37BOT          DA1                8192
     000DE37BOTDA1META   4WayReplication  000DE37BOT          DA1                1024
     000DE37BOTDA2DATA   8+3p             000DE37BOT          DA2                8192
     000DE37BOTDA2META   4WayReplication  000DE37BOT          DA2                1024
     000DE37BOTDA3DATA   8+3p             000DE37BOT          DA3                8192
     000DE37BOTDA3META   4WayReplication  000DE37BOT          DA3                1024
     000DE37BOTDA4DATA   8+3p             000DE37BOT          DA4                8192
     000DE37BOTDA4META   4WayReplication  000DE37BOT          DA4                1024
     000DE37BOTLOG       3WayReplication  000DE37BOT          LOG                1024  log
     000DE37TOPDA1DATA   8+3p             000DE37TOP          DA1                8192
     000DE37TOPDA1META   4WayReplication  000DE37TOP          DA1                1024
     000DE37TOPDA2DATA   8+3p             000DE37TOP          DA2                8192
     000DE37TOPDA2META   4WayReplication  000DE37TOP          DA2                1024
     000DE37TOPDA3DATA   8+3p             000DE37TOP          DA3                8192
     000DE37TOPDA3META   4WayReplication  000DE37TOP          DA3                1024
     000DE37TOPDA4DATA   8+3p             000DE37TOP          DA4                8192
     000DE37TOPDA4META   4WayReplication  000DE37TOP          DA4                1024
     000DE37TOPLOG       3WayReplication  000DE37TOP          LOG                1024  log
    
  2. The following command example shows how to list only those vdisks in the cluster that do not have NSDs defined on them:
    # mmlsvdisk --non-nsd
    

    The system displays output similar to the following:

                                                              declustered  block size
     vdisk name          RAID code        recovery group         array       in KiB    remarks
     ------------------  ---------------  ------------------  -----------  ----------  -------
     000DE37BOTLOG       3WayReplication  000DE37BOT          LOG                1024  log
     000DE37TOPLOG       3WayReplication  000DE37TOP          LOG                1024  log
    
  3. The following command example shows how to see complete information about the vdisks in declustered array DA1 of recovery group 000DE37TOP:
    mmlsvdisk --recovery-group 000DE37TOP --declustered-array DA1

    The system displays output similar to the following:

    vdisk:
      name = "000DE37TOPDA1META"
      raidCode = "4WayReplication"
      recoveryGroup = "000DE37TOP"
      declusteredArray = "DA1"
      blockSizeInKib = 1024
      size = "250 GiB"
      state = "ok"
      remarks = ""
    
    vdisk:
      name = "000DE37TOPDA1DATA"
      raidCode = "8+3p"
      recoveryGroup = "000DE37TOP"
      declusteredArray = "DA1"
      blockSizeInKib = 16384
      size = "17 TiB"
      state = "ok"
      remarks = ""

See also

See also the following IBM Storage Scale RAID: Administration topics:

Location

/usr/lpp/mmfs/bin