IBM General Parallel File System for AIX: Administration and Programming Reference

mmlsdisk Command

Name

mmlsdisk - Displays the current configuration and state of the disks in a file system.

Synopsis

mmlsdisk Device [-d "DiskName;[DiskName...]] [-e] [-i]

Description

Use the mmlsdisk command to display the current state of the disks in the file system.

The mmlsdisk command may be run against a mounted or unmounted file system.

For each disk in the list, mmlsdisk displays:

• disk name
• driver type
• sector size
• failure group
• whether or not it holds metadata
• whether or not it holds data
• current status:

  ready

  Normal status

  suspended

  Indicates that data is to be migrated off this disk

  being emptied

  Transitional status in effect while a disk deletion is pending

  replacing

  Transitional status in effect for old disk while replacement is pending

  replacement

  Transitional status in effect for new disk while replacement is pending

• availability:

  up

  Disk is available to GPFS for normal read and write operations

  down

  No read and write operations can be performed on this disk

  recovering

  An intermediate state for disks coming up, during which GPFS verifies and corrects data. read operations can be performed while a disk is in this state but write operations cannot.

  unrecovered

  The disks was not successfully brought up.

• disk id

Parameters

Device

The device name of the file system to which the disks belong. File system names need not be fully qualified. fs0 is as acceptable as /dev/fs0.

This must be the first parameter.

-d DiskName[;DiskName...]

The name of the disks for which you want to display current configuration and state information. When you enter multiple DiskNames, you must separate them with semicolons and enclose the entire string of disk names in quotation marks:

"gpfs3n12;gpfs4n12;gpfs5n12"

Options

-e

Display all of the disks in the file system that do not have an availability of up and a status of ready. If all disks in the file system are up and ready, the message displayed is:

6027-623 All disks up and ready 

-i

Display the disk id.

Exit status

0

Successful completion.

1

A failure has occurred.

Security

In an SP environment:

• If you are a root user:
  • You may issue the mmlsdisk command from any node running GPFS or the CWS.
  • Verify the authentication method set for SP security services:
    1. If your authentication method is set to compatibility, Kerberos authentication is required. Issue the k4init command.
    2. If your authentication method is set to DCE, dce_login authentication is required.
    3. If your authentication method is set to NONE/std, there must be an entry in the /etc/sysctl.mmcmd.acl file on every node in the nodeset for the root user at every other node in the nodeset.

    For further information, see the latest IBM Parallel System Support Programs for AIX: Administration Guide, IBM Parallel System Support Programs for AIX: Command and Technical Reference, and RS/6000: Planning Volume 2, Control Workstation and Software Environment manuals at www.rs6000.ibm.com/resource/aix_resource/sp_books/pssp. Search for information on sysctl.

• If you are executing the mmlsdisk command from the CWS on a multi-partitioned system, the SP_NAME environment variable must be properly set. It is suggested that you use a separate window for each partition and set the environment variable accordingly. For further information, see the IBM Parallel System Support Programs for AIX: Administration Guide and search for understanding system partitioning.

In an HACMP environment:

1. If you are a root user, when using rcp and rsh for remote communication, a properly configured /.rhosts file must exist in the root user's home directory on each node in the GPFS cluster. If you have designated the use of a different remote communication program on either the mmcrcluster or the mmchcluster command, you must insure:
   1. Proper authorization is granted to all nodes in the GPFS cluster.
   2. The nodes in the GPFS cluster can communicate without the use of a password.
2. You may issue the mmlsdisk command from any node in the GPFS cluster.

If you are a non-root user, you may only specify file systems that belong to the same nodeset as the node on which the mmlsdisk command was issued.

Examples

1. To display the current state of gpfs3n12, enter:

   mmlsdisk /dev/fs0 -d gpfs3n12
   

   The system displays information similar to:

   disk         driver   sector failure holds    holds                             
   name         type       size   group metadata data  status        availability  
   ------------ -------- ------ ------- -------- ----- ------------- ------------  
   gpfs3n12         disk    512      -1 yes      yes   ready         up 
    
   

2. To display the current states of gpfs3n12, gpfs4n12, and gpfs5n12, enter:

   mmlsdisk /dev/fs0 -d "gpfs3n12;gpfs4n12;gpfs5n12" -i
   

   The system displays information similar to:

   disk         driver   sector failure holds    holds                            
   name         type       size   group metadata data  status        availability disk id 
   ------------ -------- ------ ------- -------- ----- ------------- ------------ ------- 
   gpfs3n12     disk        512      -1 yes      yes   ready         up                 1 
   gpfs3n12     disk        512      -1 yes      yes   ready         up                 1
   gpfs4n12     disk        512      -1 yes      yes   ready         up                 2
   gpfs5n12     disk        512      -1 yes      yes   ready         up                 3   
   

See also

mmadddisk Command

mmchdisk Command

mmdeldisk Command

mmrpldisk Command

Location

/usr/lpp/mmfs/bin