mmlsnsd command

Displays Network Shared Disk (NSD) information for the GPFS™ cluster.

Synopsis

mmlsnsd [-a | -F | -f Device | -d "DiskName[;DiskName...]"]
        [-L | -m | -M | -X] [-Y  | -v]

Availability

Available on all IBM Spectrum Scale™ editions.

Description

Use the mmlsnsd command to display the current information for the NSDs belonging to the GPFS cluster. The default is to display information for all NSDs defined to the cluster (-a). Otherwise, you may choose to display the information for a particular file system (-f) or for all disks that do not belong to any file system (-F).

Parameters

-a
Displays information for all of the NSDs belonging to the GPFS cluster. This is the default.
-f Device
Specifies the device name of the file system for which you want NSD information displayed. File system names need not be fully-qualified. fs0 is as acceptable as /dev/fs0.
-F
Displays the NSDs that are not in use.
-d DiskName[;DiskName...]
Specifies the name of the NSDs for which you want information displayed. When you enter multiple DiskNames, separate them with semicolons and enclose the entire string of disk names in quotation marks: 
"gpfs3nsd;gpfs4nsd;gpfs5nsd"

Options

-L
Displays the information in a long format that shows the NSD identifier.
-m
Maps the NSD name to its disk device name on the local node and, if applicable, on the NSD server nodes.
-M
Maps the NSD names to its disk device name on all nodes.

This is a slow operation and its usage is suggested for problem determination only.

-v
Specifies that the output should contain error information, where available.
-X
Maps the NSD name to its disk device name on the local node and, if applicable, on the NSD server nodes. The -X option also displays extended information for the NSD volume ID and information such as NSD server status and Persistent Reserve (PR) enablement in the Remarks field. Using the -X option is a slow operation and is recommended only for problem determination.
-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.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to issue the mmlsnsd 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 default information for all of the NSDs belonging to the cluster, issue this command: 
    mmlsnsd
    The system displays information similar to: 
     File system   Disk name    NSD servers
---------------------------------------------------------------------------
 fs2           hd3n97       c5n97g,c5n98g,c5n99g
 fs2           hd4n97       c5n97g,c5n98g,c5n99g
 fs2           hd5n98       c5n98g,c5n97g,c5n99g
 fs2           hd6n98       c5n98g,c5n97g,c5n99g
 fs2           hd7n97       c5n97g,c5n98g,c5n99g
 fs2           hd8n97       c5n97g,c5n98g,c5n99g
 fs2           hd9n97       c5n97g,c5n98g,c5n99g
 fs2           hd10n98      c5n98g,c5n97g,c5n99g
 fs2           hd11n98      c5n98g,c5n97g
 fs2           hd12n98      c5n98g,c5n97g
 fs2           sdbnsd       c5n94g,c5n96g
 fs2           sdcnsd       c5n94g,c5n96g
 fs2           sddnsd       c5n94g,c5n96g
 fs2           sdensd       c5n94g,c5n96g
 fs2           sdgnsd       c5n94g,c5n96g
 fs2           sdfnsd       c5n94g,c5n96g
 fs2           sdhnsd       c5n94g,c5n96g
 (free disk)   hd2n97       c5n97g,c5n98g
  2. To display all of the NSDs attached to the node from which the command is issued, issue this command: 
    mmlsnsd -m
    The system displays information similar to: 
     Disk name    NSD volume ID      Device         Node name  Remarks
----------------------------------------------------------------------
 hd10n98      0972846245C8E93C   /dev/hd10n98   c5n97g     server node
 hd10n98      0972846245C8E93C   /dev/hd10n98   c5n98g     server node
 hd11n98      0972846245C8E93F   /dev/hd11n98   c5n97g     server node
 hd11n98      0972846245C8E93F   /dev/hd11n98   c5n98g     server node
 hd12n98      0972846245C8E941   /dev/hd12n98   c5n97g     server node
 hd12n98      0972846245C8E941   /dev/hd12n98   c5n98g     server node
 hd2n97       0972846145C8E924   /dev/hdisk2    c5n97g     server node
 hd2n97       0972846145C8E924   /dev/hdisk2    c5n98g     server node
 hd3n97       0972846145C8E927   /dev/hdisk3    c5n97g     server node
 hd3n97       0972846145C8E927   /dev/hdisk3    c5n98g     server node
 hd4n97       0972846145C8E92A   /dev/hdisk4    c5n97g     server node
 hd4n97       0972846145C8E92A   /dev/hdisk4    c5n98g     server node
 hd5n98       0972846245EB501C   /dev/hdisk5    c5n97g     server node
 hd5n98       0972846245EB501C   /dev/hdisk5    c5n98g     server node
 hd6n98       0972846245DB3AD8   /dev/hdisk6    c5n97g     server node
 hd6n98       0972846245DB3AD8   /dev/hdisk6    c5n98g     server node
 hd7n97       0972846145C8E934   /dev/hd7n97    c5n97g     server node
  3. To display all of the NSDs in the GPFS cluster in extended format, issue this command: 
    mmlsnsd -L
    The system displays information similar to: 
     File system   Disk name    NSD volume ID      NSD servers
------------------------------------------------------------
 fs2           hd3n97       0972846145C8E927   c5n97g,c5n98g
 fs2           hd4n97       0972846145C8E92A   c5n97g,c5n98g
 fs2           hd5n98       0972846245EB501C   c5n98g,c5n97g
 fs2           hd6n98       0972846245DB3AD8   c5n98g,c5n97g
 fs2           sdbnsd       0972845E45C8E8ED   c5n94g,c5n96g
 fs2           sdcnsd       0972845E45C8E8F6   c5n94g,c5n96g
 fs2           sddnsd       0972845E45F83FDB   c5n94g,c5n96g
 fs2           sdensd       0972845E45C8E909   c5n94g,c5n96g
 fs2           sdgnsd       0972845E45C8E912   c5n94g,c5n96g
 fs2           sdfnsd       0972845E45F02E81   c5n94g,c5n96g
 fs2           sdhnsd       0972845E45C8E91C   c5n94g,c5n96g
 gpfs1         hd2n97       0972846145C8E924   c5n97g,c5n98g
  4. To display extended disk information about disks hd3n97, sdfnsd, and hd5n98, issue this command: 
    mmlsnsd -X -d "hd3n97;sdfnsd;hd5n98"
    The system displays information similar to: 
     Disk name    NSD volume ID      Device         Devtype  Node name  Remarks
 ------------------------------------------------------------------------------------
 hd3n97       0972846145C8E927   /dev/hdisk3    hdisk    c5n97g     server node,pr=no
 hd3n97       0972846145C8E927   /dev/hdisk3    hdisk    c5n98g     server node,pr=no
 hd5n98       0972846245EB501C   /dev/hdisk5    hdisk    c5n97g     server node,pr=no
 hd5n98       0972846245EB501C   /dev/hdisk5    hdisk    c5n98g     server node,pr=no
 sdfnsd       0972845E45F02E81   /dev/sdf       generic  c5n94g     server node
 sdfnsd       0972845E45F02E81   /dev/sdm       generic  c5n96g     server node
  5. The following shows the output of mmlsnsd -X with mmchconfig usePersistentReserve=yes.
     Disk name    NSD volume ID      Device         Devtype  Node name                Remarks
---------------------------------------------------------------------------------------------------
 nsd0         947AC0A84F5FB55C   /dev/dm-0      dmm      c13c1apv12.gpfs.net      server node,pr=yes
 nsd0         947AC0A84F5FB55C   /dev/dm-19     dmm      c13c1apv13.gpfs.net      server node,pr=yes
 nsd0         947AC0A84F5FB55C   /dev/dm-6      dmm      c13c1apv14.gpfs.net      server node,pr=yes
 nsd0         947AC0A84F5FB55C   /dev/dm-15     dmm      c13c1apv16.gpfs.net      server node,pr=yes
 nsd1         947AC0A84F5FB564   /dev/dm-1      dmm      c13c1apv12.gpfs.net      server node,pr=yes
 nsd1         947AC0A84F5FB564   /dev/dm-4      dmm      c13c1apv13.gpfs.net      server node,pr=yes
 nsd1         947AC0A84F5FB564   /dev/dm-9      dmm      c13c1apv14.gpfs.net      server node,pr=yes
 nsd1         947AC0A84F5FB564   /dev/dm-13     dmm      c13c1apv16.gpfs.net      server node,pr=yes

See also

Location

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