mmaddpdisk command

Adds a pdisk to an IBM Storage Scale RAID recovery group.

Synopsis

mmaddpdisk RecoveryGroupName -F StanzaFile [--replace | --replace-or-add] [-v {yes | no}]

Availability

Available on all IBM Storage Scale editions.

Description

The mmaddpdisk command adds a pdisk to a recovery group.
Note: The GPFS daemon must be running on both the primary and backup servers to run this command.

Parameters

RecoveryGroupName
Specifies the recovery group to which the pdisks are being added.
-F StanzaFile
Specifies a file containing pdisk stanzas that identify the pdisks to be added. For more information about pdisk stanzas, see the following IBM Storage Scale RAID: Administration topic: Pdisk stanza format.
--replace
Indicates that any existing pdisk that has the same name as a pdisk listed in the stanza file is to be replaced. (This is an atomic deletion and addition.)
--replace-or-add
Similar to --replace. The difference is that, if a pdisk entry in the stanza file is not found in the recovery group that matches the RecoveryGroupName, the pdisk entry is treated as a new pdisk to be created.
-v {yes | no}
Verifies that specified pdisks do not belong to an existing recovery group. The default is -v yes.

Specify -v no only when you are certain that the specified disk does not belong to an existing recovery group. Using -v no on a disk that already belongs to a recovery group will corrupt that recovery group.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmaddpdisk command.

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

Examples

In this example, suppose the input stanza file, pdisk.c033d2, contains the following lines:
%pdisk: pdiskName=c033d2
        device=/dev/hdisk674
        da=DA2
        nPathActive=2
        nPathTotal=4

This command example shows how to add the pdisk described in stanza file pdisk.c033d2 to recovery group 000DE37BOT:

mmaddpdisk 000DE37BOT -F pdisk.c033d2

See also

See also the following IBM Storage Scale RAID: Administration topics:

Location

/usr/lpp/mmfs/bin