GPFS: Administration and Programming Reference - IRA Home

mmrpldisk Command
Name
mmrpldisk – Replaces the specified disk.
Synopsis
mmrpldisk Device DiskName {DiskDesc | -F DescFile} [-v yes | no] [-N {Node[,Node...] | NodeFile |
NodeClass}]
Description
Use the mmrpldisk command to replace an existing disk in the GPFS file system with a new one. All data
on the old disk is migrated to the new one.
To replace disks in a GPFS file system, you must first decide if you will:
1. Create new disks using the mmcrnsd command.
Use the rewritten disk descriptor file produced by the mmcrnsd command or create a new disk
descriptor. When using the rewritten file, the Disk Usage and Failure Group specifications remain the
same as specified on the mmcrnsd command.
2. Select disks no longer in use in any file system. Issue the mmlsnsd -F command to display the
available disks.
The disk may then be used to replace a disk in the file system using the mmrpldisk command.
Notes:
1. You cannot replace a disk when it is the only remaining disk in the file system.
2. Under no circumstances should you replace a stopped disk. You need to start a stopped disk before
replacing it. If a disk cannot be started, you must delete it using the mmdeldisk command. See the
General Parallel File System: Problem Determination Guide and search for Disk media failure.
3. The file system need not be unmounted before the mmrpldisk command can be run.
4. I/O operations from SANergy clients must terminate before using the mmrpldisk command. If not, the
client applications receive an error.
Results
Upon successful completion of the mmrpldisk command, the disk is replaced in the file system and data
is copied to the new disk without restriping.
Parameters
Device
The device name of the file system where the disk is to be replaced. File system names need not
be fully-qualified. fs0 is as acceptable as /dev/fs0.
This must be the first parameter.
Disk Name
The name of the disk to be replaced, which was previously passed to the mmcrfs, mmadddisk,
or mmrpldisk commands. You can display the entire list of disk names by issuing the mmlsdisk
command.
DiskDesc
A descriptor for the replacement disk.
-F DescFile
Specifies a file containing the disk descriptor for the replacement disk.
Chapter 8. GPFS commands 259