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
- To display the default information for all of the NSDs belonging
to the cluster, issue this command:
The system displays information similar to:mmlsnsd
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
- To display all of the NSDs attached to the node from which the
command is issued, issue this command:
The system displays information similar to:mmlsnsd -m
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
- To display all of the NSDs in the GPFS cluster
in extended format, issue this command:
The system displays information similar to:mmlsnsd -L
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
- To display extended disk information about disks hd3n97, sdfnsd,
and hd5n98, issue this command:
The system displays information similar to:mmlsnsd -X -d "hd3n97;sdfnsd;hd5n98"
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
- 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