.TH mmlsnsd 02/16/06
mmlsnsd Command
.SH "Name"
.PP
\fBmmlsnsd\fR - Displays the current Network Shared Disk (NSD)
information in the GPFS cluster.
.SH "Synopsis"
.PP
\fBmmlsnsd\fR [\fB\fI-a\fR\fR | \fB-F\fR | \fB-f\fR
\fIDevice\fR | \fB-d\fR
"\fIDiskName\fR[;\fIDiskName\fR...]" ]
[\fB-L\fR | \fB-m\fR | \fB-M\fR | \fB-X\fR]
[\fB-v\fR]
.SH "Description"
.PP
Use the \fBmmlsnsd\fR 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 (\fB-a\fR).
Otherwise, you may choose to display the information for a particular file
system (\fB-f\fR) or for all disks that do not belong to any file system
(\fB-F\fR).
.SH "Parameters"
.PP
.RS +3
\fB-a
\fR
.RE
.RS +9
Display information for all of the NSDs belonging to the GPFS
cluster. This is the default.
.RE
.PP
.RS +3
\fB-f \fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system for which you want NSD information
displayed. File system names need not be fully-qualified.
\fBfs0\fR is as acceptable as \fB/dev/fs0\fR.
.RE
.PP
.RS +3
\fB-F
\fR
.RE
.RS +9
Display the NSDs that do not belong to any file system in the GPFS
cluster.
.RE
.PP
.RS +3
\fB-d \fIDiskName\fR[;\fIDiskName\fR...]
\fR
.RE
.RS +9
.PP
The name of the NSDs for which you want information displayed. When
you enter multiple \fIDiskName\fRs, you must separate them with semicolons
and enclose the entire string of disk names in quotation marks:
.sp
.nf
"gpfs3nsd;gpfs4nsd;gpfs5nsd"
.fi
.sp
.RE
.SH "Options"
.PP
.RS +3
\fB-L
\fR
.RE
.RS +9
Display the information in a long format that shows the NSD
identifier.
.RE
.PP
.RS +3
\fB-m
\fR
.RE
.RS +9
Map the NSD name to its disk device name in \fB/dev\fR on the local
node and, if applicable, on the primary and backup NSD server nodes.
.RE
.PP
.RS +3
\fB-M
\fR
.RE
.RS +9
Map the NSD names to its disk device name in \fB/dev\fR on all
nodes.
.PP
This is a slow operation and its usage is suggested for problem
determination only.
.RE
.PP
.RS +3
\fB-v
\fR
.RE
.RS +9
Specifies that the output should contain error information, where
available.
.RE
.PP
.RS +3
\fB-X
\fR
.RE
.RS +9
Map the NSD name to its disk device name in \fB/dev\fR on the local
node and, if applicable, on the primary and backup NSD server nodes, showing
the information with extended information in the NSD volume id and the remarks
fields. This is a slow operation and is suggested only for problem
determination.
.RE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion.
.RE
.PP
.RS +3
\fBnonzero
\fR
.RE
.RS +9
A failure has occurred.
.RE
.SH "Security"
.PP
You must have root authority to issue the \fBmmlsnsd\fR command.
.PP
You may issue the \fBmmlsnsd\fR command from any node in the GPFS
cluster.
.PP
When using the \fBrcp\fR and \fBrsh\fR commands for remote
communication, a properly configured \fB.rhosts\fR 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
\fBmmcrcluster\fR
or the
\fBmmchcluster\fR command, you must
ensure:
.RS +3
.HP 3
1. Proper authorization is granted to all nodes in the GPFS cluster.
.HP 3
2. The nodes in the GPFS cluster can communicate without the use of a
password, and without any extraneous messages.
.RE
.SH "Examples"
.RS +3
.HP 3
1. To display the default information for all of the NSDs belonging to the
cluster, issue this command:
.sp
.nf
mmlsnsd
.fi
.sp
The system displays information similar to:
.sp
.nf
File system  Disk name  Primary node       Backup node
--------------------------------------------------------
gpfsa        gpfs16nsd  k145n06            k145n07
gpfsa        gpfs17nsd  k145n06            k145n07
gpfsa        gpfs18nsd  k145n06            k145n07
gpfsa        gpfs19nsd  k145n06            k145n07
gpfsa        gpfs20nsd  k145n06            k145n07
gpfs1        gpfs1nsd   (directly attached)
gpfs1        gpfs2nsd   (directly attached)
gpfs1        gpfs3nsd   (directly attached)
gpfs1        gpfs4nsd   (directly attached)
\ 
.fi
.sp
.HP 3
2. To display all of the NSDs attached to the node from which the command is
issued, issue this command:
.sp
.nf
mmlsnsd -m
.fi
.sp
The system displays information similar to:
.sp
.nf
Disk name NSD volume ID     Device    Node name Remarks
------------------------------------------------------------
gpfs16nsd 097284213AA842EC  /dev/sdb  k145n06   primary node\ 
gpfs16nsd 097284213AA842EC  /dev/sdb  k145n07   backup node\ 
gpfs17nsd 097284213AA842EF  /dev/sdc  k145n06   primary node
gpfs17nsd 097284213AA842EF  /dev/sdc  k145n07   backup node\ 
gpfs18nsd 097284213AA842F2  /dev/sdd  k145n06   primary node
gpfs18nsd 097284213AA842F2  /dev/sdd  k145n07   backup node\ 
gpfs19nsd 097284213AA842F5  /dev/sde  k145n06   primary node
gpfs19nsd 097284213AA842F5  /dev/sde  k145n07   backup node\ 
gpfs20nsd 097284213AA842F7  /dev/sdf  k145n06   primary node
gpfs20nsd 097284213AA842F7  /dev/sdf  k145n07   backup node\ 
gpfs1nsd  0972841D3AA8420A  -         k145n06 (not found) directly attached
gpfs2nsd  0972841D3AA8420B  -         k145n06 (not found) directly attached\ 
gpfs3nsd  0972841D3AA8420C  -         k145n06 (not found) directly attached
gpfs4nsd  0972841D3AA8420D  -         k145n06 (not found) directly attached
\ 
.fi
.sp
.HP 3
3. To display all of the NSDs in the GPFS cluster in extended format, issue
this command:
.sp
.nf
mmlsnsd -L
.fi
.sp
The system displays information similar to:
.sp
.nf
File system Disk name NSD volume ID   Primary node  Backup node
---------------------------------------------------------------
gpfsa      gpfs16nsd  097284213AA842EC  k145n06        k145n07
gpfsa      gpfs17nsd  097284213AA842EF  k145n06        k145n07
gpfsa      gpfs18nsd  097284213AA842F2  k145n06        k145n07
gpfsa      gpfs19nsd  097284213AA842F5  k145n06        k145n07
gpfsa      gpfs20nsd  097284213AA842F7  k145n06        k145n07
gpfs1      gpfs1nsd   0972841D3AA8420A  (directly attached)
gpfs1      gpfs2nsd   0972841D3AA8420B  (directly attached)
gpfs1      gpfs3nsd   0972841D3AA8420C  (directly attached)
gpfs1      gpfs4nsd   0972841D3AA8420D  (directly attached)
.fi
.sp
.HP 3
4. To display extended disk information about disks \fBgpfs10nsd\fR,
\fBgpfs11nsd\fR, \fBsdbnsd\fR, and \fBvp10vsdn06\fR, issue this
command:
.sp
.nf
mmlsnsd -X -d "gpfs10nsd;gpfs11nsd;sdbnsd;vp10vsdn06"
.fi
.sp
The system displays information similar to:
.sp
.nf
Disk name   NSD volume ID     Device          Devtype  Node name             Remarks
------------------------------------------------------------------------------------------------
gpfs10nsd   09725E5E43035A99  /dev/hdisk6     hdisk    k155n14.kgn.ibm.com   primary
gpfs10nsd   09725E5E43035A99  /dev/hdisk8     hdisk    k155n16.kgn.ibm.com   backup
gpfs11nsd   09725E5E43035AA6  /dev/vpath12    vpath    k155n14.kgn.ibm.com   primary
gpfs11nsd   09725E5E43035AA6  /dev/vpath12    vpath    k155n16.kgn.ibm.com   backup
sdbnsd      09725E024328783A  /dev/sdb        generic  k156gn02.kgn.ibm.com  primary
sdbnsd      09725E024328783A  -               generic  k156gn03.kgn.ibm.com  (not found) backup
vsdn06   09725E46432877ED     /dev/vsdn06     vsd      k154gn05.kgn.ibm.com  backup;state=ACT;
lv=vsdn06lv;vg=vsdn06vg
vsdn06  09725E46432877ED      /dev/vsdn06     vsd      k154gn06.kgn.ibm.com  primary;state=ACT;
lv=vsdn06lv;vg=vsdn06vg
\ 
.fi
.sp
.RE
.SH "See also"
.PP
mmcrnsd Command
.PP
mmdelnsd Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP