mmdelpdisk command

Deletes IBM Storage Scale RAID pdisks.

Synopsis

mmdelpdisk RecoveryGroupName {--pdisk "PdiskName[;PdiskName...]" | -F StanzaFile} [-a]

mmdelpdisk RecoveryGroupName --declustered-array DeclusteredArrayName

Availability

Available on all IBM Storage Scale editions.

Description

The mmdelpdisk command deletes one or more pdisks. Deleting a pdisk causes any data allocated to that disk to be moved or rebuilt (drained) to spare space in the declustered array.

The mmdelpdisk command first renames each pdisk that is to be deleted, giving it a temporary name. The command then drains each renamed pdisk to remove all data from it. Finally, the command destroys each renamed pdisk once all data has been drained from it.

Note: The temporary name is obtained by appending a suffix in the form #nnnn to the pdisk name. For example, a pdisk named p25 will receive a temporary name similar to p25#010; this allows you to use the mmaddpdisk command to add a new pdisk with the name p25 immediately rather than waiting for the old disk to be completely drained and removed. Until the draining and removing process is complete, both the new pdisk p25 and the old pdisk p25#0010 will show up in the output of the mmlsrecoverygroup and mmlspdisk commands.

If mmdelpdisk is interrupted (by an interrupt signal or by GPFS server failover), the deletion will proceed and will be completed as soon as another IBM Storage Scale RAID server becomes the active vdisk server of the recovery group.

If you wish to delete a declustered array and all pdisks in that declustered array, use the --declustered-array DeclusteredArrayName form of the command.

The mmdelpdisk command cannot be used if the declustered array does not have enough spare space to hold the data that needs to be drained, or if it attempts to reduce the size of a large declustered array below the limit for large declustered arrays. Normally, all of the space in a declustered array is allocated to vdisks and spares, and therefore the only times the mmdelpdisk command typically can be used is after adding pdisks, after deleting vdisks, or after reducing the designated number of spares. See the following topics: mmaddpdisk command and mmchcarrier command.

Note: The recovery group must be active to run this command.

Parameters

RecoveryGroupName: Specifies the recovery group from which the pdisks are being deleted.
--pdisk "PdiskName[;PdiskName...]": Specifies a semicolon-separated list of pdisk names identifying the pdisks to be deleted.
-F StanzaFile: Specifies a file that contains pdisk stanzas identifying the pdisks to be deleted. For more information about pdisk stanzas, see the the following IBM Storage Scale RAID: Administration topic: Pdisk stanza format.
Note: Only the pdiskName parameter is used. All other parameters are ignored.
-a: Indicates that the data on the deleted pdisks is to be drained asynchronously. The pdisk will continue to exist, with its name changed to a temporary name, while the deletion progresses.
--declustered-array DeclusteredArrayName: Specifies the name of the declustered array whose pdisks are to be deleted.

Exit status

0: Successful completion.
nonzero: A failure has occurred.

Security

You must have root authority to run the mmdelpdisk command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For additional details, see the following IBM Storage Scale RAID: Administration topic: Requirements for administering IBM Storage Scale RAID.

Examples

The following command example shows how to remove pdisk c016d1 from recovery group 000DE37TOP and have it be drained in the background, thereby returning the administrator immediately to the command prompt:

mmdelpdisk 000DE37TOP --pdisk c016d1 -a

Location

/usr/lpp/mmfs/bin