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

Last change on this file since 173 was 16, checked in by rock, 17 years ago
File size: 7.0 KB
Line 
1.TH mmdeldisk 03/31/06
2mmdeldisk Command
3.SH "Name"
4.PP
5\fBmmdeldisk\fR - Deletes disks from a GPFS file system.
6.SH "Synopsis"
7.PP
8\fBmmdeldisk\fR \fIDevice\fR
9{"\fIDiskDesc\fR[;\fIDiskDesc\fR...]"
10| \fB-F\fR \fIDescFile\fR} [\fB-a\fR]
11[\fB-c\fR] [\fB-r\fR] [\fB-N\fR
12{\fINode\fR[,\fINode\fR...] | \fINodeFile\fR | \fINodeClass\fR}]
13.SH "Description"
14.PP
15The \fBmmdeldisk\fR command migrates all data that would otherwise be
16lost to the remaining disks in the file system. It then removes the
17disks from the file system descriptor and optionally rebalances the file
18system after removing the disks.
19.PP
20Run the \fBmmdeldisk\fR command when system demand is low.
21.PP
22I/O operations from SANergy clients must terminate before using the
23\fBmmdeldisk\fR command. If not, the client applications receive an
24error.
25.PP
26If a replacement for a failing disk is available, use the \fBmmrpldisk\fR command in order to keep the file system
27balanced. Otherwise, use one of these procedures to delete a
28disk:
29.RS +3
30.HP 3
31\(bu If the disk is not failing and GPFS can still read from it:
32.RS +3
33.HP 3
341. Suspend the disk
35.HP 3
362. Restripe to rebalance all data onto other disks
37.HP 3
383. Delete the disk
39.RE
40.HP 3
41\(bu If the disk is permanently damaged and the file system is
42replicated:
43.RS +3
44.HP 3
451. Suspend and stop the disk.
46.HP 3
472. restripe and restore replication for the file system, if possible.
48.HP 3
493. Delete the disk from the file system.
50.RE
51.HP 3
52\(bu If the disk is permanently damaged and the file system is not replicated,
53or if the \fBmmdeldisk\fR command repeatedly fails, see the
54\fIGeneral Parallel File System: Problem
55Determination Guide\fR and search for \fIDisk media
56failure\fR.
57.RE
58.PP
59If the last disk in a storage pool is deleted, the storage pool is
60deleted. The \fBmmdeldisk\fR command is not permitted to delete the
61\fBsystem\fR storage pool. A storage pool must be empty in order for
62it to be deleted.
63.PP
64\fBResults\fR
65.PP
66Upon successful completion of the \fBmmdeldisk\fR command, these tasks
67are completed:
68.RS +3
69.HP 3
70\(bu Data that has not been replicated from the target disks is migrated to
71other disks in the file system.
72.HP 3
73\(bu Remaining disks are rebalanced, if specified.
74.RE
75.SH "Parameters"
76.PP
77.RS +3
78\fB\fIDevice\fR
79\fR
80.RE
81.RS +9
82The device name of the file system to delete the disks from. File
83system names need not be fully-qualified. \fBfs0\fR is as acceptable
84as \fB/dev/fs0\fR. This must be the first parameter.
85.RE
86.PP
87.RS +3
88\fB"\fIDiskDesc\fR[;\fIDiskDesc\fR...]"
89.PP
90\fR
91.RE
92.RS +9
93The disk descriptors of the disks to be deleted from the file
94system. If there is more than one disk to be deleted, delimit each
95descriptor with a semicolon (;) and enclose the list of disk descriptors
96in quotation marks.
97.RE
98.PP
99.RS +3
100\fB-F \fIDescFile\fR
101\fR
102.RE
103.RS +9
104A file that contains a list of disk descriptors, one per line representing
105disks, to be deleted.
106.RE
107.PP
108.RS +3
109\fB-N {\fINode\fR[,\fINode\fR...] |
110\fINodeFile\fR | \fINodeClass\fR }
111\fR
112.RE
113.RS +9
114Specify the nodes that participate in the restripe of the file system
115after the specified disks have been removed. This command supports all
116defined node classes. The default is \fBall\fR (all nodes in the
117GPFS cluster will participate in the restripe of the file system).
118.PP
119For information on how to specify node names, see \fISpecifying nodes as input to GPFS commands\fR
120in \fIGPFS: Administration and Programming Reference\fR.
121.RE
122.SH "Options"
123.PP
124.RS +3
125\fB-a
126\fR
127.RE
128.RS +9
129Specifies that the \fBmmdeldisk\fR command \fInot\fR wait for
130rebalancing to complete before returning. When this flag is specified,
131the \fBmmdeldisk\fR command runs asynchronously and returns after the file
132system descriptor is updated and the rebalancing scan is started, but it does
133not wait for rebalancing to finish. If no rebalancing is requested
134(\fB-r \fR option is not specified), this option has no effect.
135.RE
136.PP
137.RS +3
138\fB-c
139\fR
140.RE
141.RS +9
142Specifies that processing continues even in the event that unreadable data
143exists on the disks being deleted. Data that has not been replicated is
144lost. Replicated data is not lost as long as the disks containing the
145replication are accessible.
146.RE
147.PP
148.RS +3
149\fB-r
150\fR
151.RE
152.RS +9
153Rebalance all existing files in the file system to make more efficient use
154of the remaining disks.
155.RS +3
156\fBNote:\fR
157.RE
158.RS +9
159Rebalancing of files is an I/O intensive and time consuming operation, and is
160important only for file systems with large files that are mostly
161invariant. In many cases, normal file update and creation will
162rebalance your file system over time, without the cost of the
163rebalancing.
164.RE
165.RE
166.SH "Exit status"
167.PP
168.PP
169.RS +3
170\fB0
171\fR
172.RE
173.RS +9
174Successful completion.
175.RE
176.PP
177.RS +3
178\fBnonzero
179\fR
180.RE
181.RS +9
182A failure has occurred.
183.RE
184.SH "Security"
185.PP
186You must have root authority to run the \fBmmdeldisk\fR command.
187.PP
188You may issue the \fBmmdeldisk\fR command from any node in the GPFS
189cluster.
190.PP
191When using the \fBrcp\fR and \fBrsh\fR commands for remote
192communication, a properly configured \fB.rhosts\fR file must exist
193in the root user's home directory on each node in the GPFS
194cluster. If you have designated the use of a different remote
195communication program on either the
196\fBmmcrcluster\fR
197or the
198\fBmmchcluster\fR command, you must
199ensure:
200.RS +3
201.HP 3
2021. Proper authorization is granted to all nodes in the GPFS cluster.
203.HP 3
2042. The nodes in the GPFS cluster can communicate without the use of a
205password, and without any extraneous messages.
206.RE
207.SH "Examples"
208.PP
209To delete \fBgpfs2nsd\fR and \fBgpfs3nsd\fR from file system
210\fBfs0\fR and rebalance the files across the remaining disks, issue this
211command:
212.sp
213.nf
214mmdeldisk fs0 "gpfs2nsd;gpfs3nsd" -r
215.fi
216.sp
217.PP
218The system displays information similar to:
219.sp
220.nf
221Dleting disks ...
222Scanning 'system' storage pool
223Scanning file system metadata, phase 1 ...\
224Scan completed successfully.
225Scanning file system metadata, phase 2 ...\
226Scan completed successfully.
227Scanning file system metadata, phase 3 ...\
228Scan completed successfully.
229Scanning file system metadata, phase 4 ...\
230Scan completed successfully.
231Scanning user file metadata ...
232   2 %  complete on Tue Feb 14 14:45:18 2006
233   3 %  complete on Tue Feb 14 14:45:21 2006
234   9 %  complete on Tue Feb 14 14:45:24 2006
235  18 %  complete on Tue Feb 14 14:45:27 2006
236  27 %  complete on Tue Feb 14 14:45:35 2006
237  28 %  complete on Tue Feb 14 14:45:39 2006
238  29 %  complete on Tue Feb 14 14:45:43 2006
239  30 %  complete on Tue Feb 14 14:45:52 2006
240  34 %  complete on Tue Feb 14 14:46:04 2006
241  37 %  complete on Tue Feb 14 14:46:18 2006
242  45 %  complete on Tue Feb 14 14:46:22 2006
243  51 %  complete on Tue Feb 14 14:46:26 2006
244  94 %  complete on Tue Feb 14 14:46:29 2006
245 100 %  complete on Tue Feb 14 14:46:32 2006
246Scan completed successfully.
247tsdeldisk64 completed.
248mmdeldisk: Propagating the cluster configuration data to all
249  affected nodes.  This is an asynchronous process.
250.fi
251.sp
252.SH "See also"
253.PP
254mmadddisk Command
255.PP
256mmchdisk Command
257.PP
258mmlsdisk Command
259.PP
260mmrpldisk Command
261.SH "Location"
262.PP
263\fB/usr/lpp/mmfs/bin\fR
264.PP
Note: See TracBrowser for help on using the repository browser.