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

Last change on this file since 173 was 16, checked in by rock, 17 years ago
File size: 7.5 KB
Line 
1.TH mmlsdisk 03/31/06
2mmlsdisk Command
3.SH "Name"
4.PP
5\fBmmlsdisk\fR - Displays the current configuration and state of the
6disks in a file system.
7.SH "Synopsis"
8.PP
9\fBmmlsdisk\fR \fIDevice\fR [\fB-d\fR
10\fB"\fR\fIDiskName\fR[;\fIDiskName\fR...\fB]"]\fR
11[\fB-e\fR] [\fB-L\fR]
12.PP
13Or,
14.PP
15\fBmmlsdisk\fR \fIDevice\fR [\fB-d\fR
16\fB"\fR\fIDiskName\fR[;\fIDiskName\fR...\fB]"]\fR
17{\fB-m\fR | \fB-M\fR}
18.SH "Description"
19.PP
20Use the \fBmmlsdisk\fR command to display the current state of the disks
21in the file system.
22.PP
23The \fBmmlsdisk\fR command may be run against a mounted or unmounted
24file system.
25.PP
26For each disk in the list, the \fBmmlsdisk\fR command displays:
27.RS +3
28.HP 3
29\(bu disk name
30.HP 3
31\(bu driver type
32.HP 3
33\(bu sector size
34.HP 3
35\(bu failure group
36.HP 3
37\(bu whether it holds metadata
38.HP 3
39\(bu whether it holds data
40.HP 3
41\(bu current
42status:
43.sp
44.RS +3
45\fBready
46\fR
47.RE
48.RS +9
49Normal status
50.RE
51.sp
52.RS +3
53\fBsuspended
54\fR
55.RE
56.RS +9
57Indicates that data is to be migrated off this disk
58.RE
59.sp
60.RS +3
61\fBbeing emptied
62\fR
63.RE
64.RS +9
65Transitional status in effect while a disk deletion is pending
66.RE
67.sp
68.RS +3
69\fBreplacing
70\fR
71.RE
72.RS +9
73Transitional status in effect for old disk while replacement is pending
74.RE
75.sp
76.RS +3
77\fBreplacement
78\fR
79.RE
80.RS +9
81Transitional status in effect for new disk while replacement is pending
82.RE
83.HP 3
84\(bu availability:
85.sp
86.RS +3
87\fBup
88\fR
89.RE
90.RS +9
91Disk is available to GPFS for normal \fBread\fR and \fBwrite\fR
92operations
93.RE
94.sp
95.RS +3
96\fBdown
97\fR
98.RE
99.RS +9
100No \fBread\fR and \fBwrite\fR operations can be performed on
101this disk
102.RE
103.sp
104.RS +3
105\fBrecovering
106\fR
107.RE
108.RS +9
109An intermediate state for disks coming up, during which GPFS verifies and
110corrects data. \fBread\fR operations can be performed while a disk
111is in this state but \fBwrite\fR operations cannot.
112.RE
113.sp
114.RS +3
115\fBunrecovered
116\fR
117.RE
118.RS +9
119The disks was not successfully brought up.
120.RE
121.HP 3
122\(bu disk ID
123.HP 3
124\(bu storage pool that the disk is assigned to
125.RE
126.SH "Parameters"
127.PP
128.RS +3
129\fB\fIDevice\fR
130\fR
131.RE
132.RS +9
133The device name of the file system to which the disks belong. File
134system names need not be fully-qualified. \fBfs0\fR is as acceptable
135as \fB/dev/fs0\fR.
136.PP
137This must be the first parameter.
138.RE
139.PP
140.RS +3
141\fB-d "\fIDiskName\fR[;\fIDiskName\fR...]"
142\fR
143.RE
144.RS +9
145The name of the disks for which you want to display current configuration
146and state information. When you enter multiple values for
147\fIDiskName\fR, you must separate them with semicolons and enclose the list
148in quotation marks.
149.sp
150.nf
151"gpfs3nsd;gpfs4nsd;gpfs5nsd"
152.fi
153.sp
154.RE
155.SH "Options"
156.PP
157.RS +3
158\fB-e
159\fR
160.RE
161.RS +9
162Display all of the disks in the file system that do not have an
163availability of \fBup\fR and a status of \fBready\fR. If all
164disks in the file system are \fBup\fR and \fBready\fR, the message
165displayed is:
166.sp
167.nf
1686027-623 All disks up and ready\
169.fi
170.sp
171.RE
172.PP
173.RS +3
174\fB-L
175\fR
176.RE
177.RS +9
178Displays an extended list of the disk parameters, including the disk ID
179field and the \fBremarks\fR field. The \fBremarks\fR column shows
180the current file system descriptor quorum assignments, and displays the
181excluded disks. The \fBremarks\fR field contains \fBdesc\fR for
182all disks assigned as the file system descriptor holders and \fBexcl\fR for
183all excluded disks.
184.RE
185.PP
186.RS +3
187\fB-M
188\fR
189.RE
190.RS +9
191Displays whether I/O requests to the disk are satisfied on the local node,
192or using an NSD server. If the I/O is done using an NSD server, shows
193the NSD server name and the underlying disk name on that server
194node.
195.RE
196.PP
197.RS +3
198\fB-m
199\fR
200.RE
201.RS +9
202Displays whether I/O requests to the disk are satisfied on the local node,
203or using an NSD server. This scope of this options is the node on which
204the \fBmmlsdisk\fR command is issued.
205.RE
206.SH "Exit status"
207.PP
208.PP
209.RS +3
210\fB0
211\fR
212.RE
213.RS +9
214Successful completion.
215.RE
216.PP
217.RS +3
218\fBnonzero
219\fR
220.RE
221.RS +9
222A failure has occurred.
223.RE
224.SH "Security"
225.PP
226If you are a root user:
227.RS +3
228.HP 3
2291. You may issue the \fBmmlsdisk\fR command from any node in the GPFS
230cluster.
231.HP 3
2322.
233When using the \fBrcp\fR and \fBrsh\fR commands for remote
234communication, a properly configured \fB.rhosts\fR file must exist
235in the root user's home directory on each node in the GPFS
236cluster. If you have designated the use of a different remote
237communication program on either the
238\fBmmcrcluster\fR
239or the
240\fBmmchcluster\fR command, you must
241ensure:
242.RS +3
243.HP 3
244a. Proper authorization is granted to all nodes in the GPFS cluster.
245.HP 3
246b. The nodes in the GPFS cluster can communicate without the use of a
247password, and without any extraneous messages.
248.RE
249.HP 3
2503. As root, the command can also do an \fBmmlsdisk\fR on remote file
251systems.
252.RE
253.PP
254If you are a non-root user, you may specify only file systems that belong
255to the same cluster as the node on which the \fBmmlsdisk\fR command was
256issued.
257.PP
258The \fBmmlsdisk\fR command does not work if GPFS is
259down.
260.SH "Examples"
261.PP
262.RS +3
263.HP 3
2641. To display the current state of \fBgpfs2nsd\fR, issue this
265command:
266.sp
267.nf
268mmlsdisk /dev/fs0 -d gpfs2nsd
269.fi
270.sp
271.sp
272The system displays information similar to:
273.sp
274.nf
275disk      driver  sector failure holds    holds                     storage
276name      type      size   group metadata data  status  availability pool
277--------  ------- ------ ------- -------- ----- ------- ------------ -------
278gpfs2nsd  nsd        512    4002 yes      yes   ready   up           system
279.fi
280.sp
281.HP 3
2822. To display the current states of \fBgpfs2nsd\fR,
283\fBgpfs3nsd\fR, and \fBgpfs4nsd\fR, and display their respective disk
284ids and the descriptor quorum assignment, issue this command:
285.sp
286.nf
287mmlsdisk /dev/fs0 -d "gpfs2nsd;gpfs3nsd;gpfs4nsd" -L
288.fi
289.sp
290.sp
291The system displays information similar to:
292.sp
293.nf
294disk      driver sector failure holds    holds                             storage
295name      type     size   group metadata data  status availability disk id pool     remarks
296--------- ------ ------ ------- -------- ----- ------ ------------ ------- -------- -------
297gpfs2nsd  nsd      512    4002  yes      yes   ready  up           2       system    desc
298gpfs3nsd  nsd      512    4002  yes      yes   ready  up           3       system
299gpfs4nsd  nsd      512    4002  yes      yes   ready  up           4       system
300Number of quorum disks: 3
301Read quorum value:      2
302Write quorum value:     2
303.fi
304.sp
305.HP 3
3063. To display the whether the I/O is performed locally or using an NSD
307server, the NSD server name, and the underlying disk name for the file system
308named \fBtest\fR, issue this command:
309.sp
310.nf
311mmlsdisk test -M
312.fi
313.sp
314.sp
315The system displays information similar to:
316.sp
317.nf
318Disk name     IO performed on node     Device             Availability
319------------  -----------------------  -----------------  ------------
320gpfs7nsd      localhost                /dev/gpfs2vsd      up
321gpfs10nsd     k5n88.kgn.ibm.com        /dev/gpfs3vsd      up
322gpfs4nsd      localhost                /dev/hdisk10       up
323.fi
324.sp
325.HP 3
3264. To display the same information as in Example 3, but limited to the node on which the command is
327issued, issue this command:
328.sp
329.nf
330mmlsdisk test -m
331.fi
332.sp
333.sp
334The system displays information similar to:
335.sp
336.nf
337Disk name     IO performed on node     Device             Availability
338------------  -----------------------  -----------------  ------------
339gpfs7nsd      localhost                /dev/gpfs2vsd      up
340gpfs10nsd     k5n88.kgn.ibm.com             -             up
341gpfs4nsd      localhost                /dev/hdisk10       up
342.fi
343.sp
344.RE
345.SH "See also"
346.PP
347mmadddisk Command
348.PP
349mmchdisk Command
350.PP
351mmdeldisk Command
352.PP
353mmrpldisk Command
354.SH "Location"
355.PP
356\fB/usr/lpp/mmfs/bin\fR
357.PP
Note: See TracBrowser for help on using the repository browser.