source: gpfs_3.1_ker2.6.20/share/man/man8/mmlsdisk.8 @ 118

.TH mmlsdisk 03/31/06
mmlsdisk Command
.SH "Name"
.PP
\fBmmlsdisk\fR - Displays the current configuration and state of the
disks in a file system.
.SH "Synopsis"
.PP
\fBmmlsdisk\fR \fIDevice\fR [\fB-d\fR
\fB"\fR\fIDiskName\fR[;\fIDiskName\fR...\fB]"]\fR
[\fB-e\fR] [\fB-L\fR]
.PP
Or,
.PP
\fBmmlsdisk\fR \fIDevice\fR [\fB-d\fR
\fB"\fR\fIDiskName\fR[;\fIDiskName\fR...\fB]"]\fR
{\fB-m\fR | \fB-M\fR}
.SH "Description"
.PP
Use the \fBmmlsdisk\fR command to display the current state of the disks
in the file system.
.PP
The \fBmmlsdisk\fR command may be run against a mounted or unmounted
file system.
.PP
For each disk in the list, the \fBmmlsdisk\fR command displays:
.RS +3
.HP 3
\(bu disk name
.HP 3
\(bu driver type
.HP 3
\(bu sector size
.HP 3
\(bu failure group
.HP 3
\(bu whether it holds metadata
.HP 3
\(bu whether it holds data
.HP 3
\(bu current
status:
.sp
.RS +3
\fBready
\fR
.RE
.RS +9
Normal status
.RE
.sp
.RS +3
\fBsuspended
\fR
.RE
.RS +9
Indicates that data is to be migrated off this disk
.RE
.sp
.RS +3
\fBbeing emptied
\fR
.RE
.RS +9
Transitional status in effect while a disk deletion is pending
.RE
.sp
.RS +3
\fBreplacing
\fR
.RE
.RS +9
Transitional status in effect for old disk while replacement is pending
.RE
.sp
.RS +3
\fBreplacement
\fR
.RE
.RS +9
Transitional status in effect for new disk while replacement is pending
.RE
.HP 3
\(bu availability:
.sp
.RS +3
\fBup
\fR
.RE
.RS +9
Disk is available to GPFS for normal \fBread\fR and \fBwrite\fR
operations
.RE
.sp
.RS +3
\fBdown
\fR
.RE
.RS +9
No \fBread\fR and \fBwrite\fR operations can be performed on
this disk
.RE
.sp
.RS +3
\fBrecovering
\fR
.RE
.RS +9
An intermediate state for disks coming up, during which GPFS verifies and
corrects data. \fBread\fR operations can be performed while a disk
is in this state but \fBwrite\fR operations cannot.
.RE
.sp
.RS +3
\fBunrecovered
\fR
.RE
.RS +9
The disks was not successfully brought up.
.RE
.HP 3
\(bu disk ID
.HP 3
\(bu storage pool that the disk is assigned to
.RE
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system to which the disks belong. File
system names need not be fully-qualified. \fBfs0\fR is as acceptable
as \fB/dev/fs0\fR.
.PP
This must be the first parameter.
.RE
.PP
.RS +3
\fB-d "\fIDiskName\fR[;\fIDiskName\fR...]"
\fR
.RE
.RS +9
The name of the disks for which you want to display current configuration
and state information. When you enter multiple values for
\fIDiskName\fR, you must separate them with semicolons and enclose the list
in quotation marks.
.sp
.nf
"gpfs3nsd;gpfs4nsd;gpfs5nsd"
.fi
.sp
.RE
.SH "Options"
.PP
.RS +3
\fB-e
\fR
.RE
.RS +9
Display all of the disks in the file system that do not have an
availability of \fBup\fR and a status of \fBready\fR. If all
disks in the file system are \fBup\fR and \fBready\fR, the message
displayed is:
.sp
.nf
6027-623 All disks up and ready\ 
.fi
.sp
.RE
.PP
.RS +3
\fB-L
\fR
.RE
.RS +9
Displays an extended list of the disk parameters, including the disk ID
field and the \fBremarks\fR field. The \fBremarks\fR column shows
the current file system descriptor quorum assignments, and displays the
excluded disks. The \fBremarks\fR field contains \fBdesc\fR for
all disks assigned as the file system descriptor holders and \fBexcl\fR for
all excluded disks.
.RE
.PP
.RS +3
\fB-M
\fR
.RE
.RS +9
Displays whether I/O requests to the disk are satisfied on the local node,
or using an NSD server. If the I/O is done using an NSD server, shows
the NSD server name and the underlying disk name on that server
node.
.RE
.PP
.RS +3
\fB-m
\fR
.RE
.RS +9
Displays whether I/O requests to the disk are satisfied on the local node,
or using an NSD server. This scope of this options is the node on which
the \fBmmlsdisk\fR command is issued.
.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
If you are a root user:
.RS +3
.HP 3
1. You may issue the \fBmmlsdisk\fR command from any node in the GPFS
cluster.
.HP 3
2. 
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
a. Proper authorization is granted to all nodes in the GPFS cluster.
.HP 3
b. The nodes in the GPFS cluster can communicate without the use of a
password, and without any extraneous messages.
.RE
.HP 3
3. As root, the command can also do an \fBmmlsdisk\fR on remote file
systems.
.RE
.PP
If you are a non-root user, you may specify only file systems that belong
to the same cluster as the node on which the \fBmmlsdisk\fR command was
issued.
.PP
The \fBmmlsdisk\fR command does not work if GPFS is
down.
.SH "Examples"
.PP
.RS +3
.HP 3
1. To display the current state of \fBgpfs2nsd\fR, issue this
command:
.sp
.nf
mmlsdisk /dev/fs0 -d gpfs2nsd
.fi
.sp
.sp
The system displays information similar to:
.sp
.nf
disk      driver  sector failure holds    holds                     storage
name      type      size   group metadata data  status  availability pool
--------  ------- ------ ------- -------- ----- ------- ------------ -------
gpfs2nsd  nsd        512    4002 yes      yes   ready   up           system
.fi
.sp
.HP 3
2. To display the current states of \fBgpfs2nsd\fR,
\fBgpfs3nsd\fR, and \fBgpfs4nsd\fR, and display their respective disk
ids and the descriptor quorum assignment, issue this command:
.sp
.nf
mmlsdisk /dev/fs0 -d "gpfs2nsd;gpfs3nsd;gpfs4nsd" -L
.fi
.sp
.sp
The system displays information similar to:
.sp
.nf
disk      driver sector failure holds    holds                             storage
name      type     size   group metadata data  status availability disk id pool     remarks
--------- ------ ------ ------- -------- ----- ------ ------------ ------- -------- -------
gpfs2nsd  nsd      512    4002  yes      yes   ready  up           2       system    desc
gpfs3nsd  nsd      512    4002  yes      yes   ready  up           3       system
gpfs4nsd  nsd      512    4002  yes      yes   ready  up           4       system
Number of quorum disks: 3
Read quorum value:      2
Write quorum value:     2
.fi
.sp
.HP 3
3. To display the whether the I/O is performed locally or using an NSD
server, the NSD server name, and the underlying disk name for the file system
named \fBtest\fR, issue this command:
.sp
.nf
mmlsdisk test -M
.fi
.sp
.sp
The system displays information similar to:
.sp
.nf
Disk name     IO performed on node     Device             Availability
------------  -----------------------  -----------------  ------------
gpfs7nsd      localhost                /dev/gpfs2vsd      up
gpfs10nsd     k5n88.kgn.ibm.com        /dev/gpfs3vsd      up
gpfs4nsd      localhost                /dev/hdisk10       up
.fi
.sp
.HP 3
4. To display the same information as in Example 3, but limited to the node on which the command is
issued, issue this command:
.sp
.nf
mmlsdisk test -m
.fi
.sp
.sp
The system displays information similar to:
.sp
.nf
Disk name     IO performed on node     Device             Availability
------------  -----------------------  -----------------  ------------
gpfs7nsd      localhost                /dev/gpfs2vsd      up
gpfs10nsd     k5n88.kgn.ibm.com             -             up
gpfs4nsd      localhost                /dev/hdisk10       up
.fi
.sp
.RE
.SH "See also"
.PP
mmadddisk Command
.PP
mmchdisk Command
.PP
mmdeldisk Command
.PP
mmrpldisk Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP