GPFS: Administration and Programming Reference - IRA Home

mmcrnsd Command
Note: This name can contain only the following characters: ’A’ through ’Z’, ’a’ through ’z’,
’0’ through ’9’, or ’_’ (the underscore). All other characters are not valid.
If a desired name is not specified, the NSD is assigned a name according to the
convention:
gpfsNNnsd where NN is a unique nonnegative integer not used in any prior NSD.
StoragePool
Specifies the name of the storage pool that the NSD is assigned to. This field is ignored
by the mmcrnsd command, and is passed unchanged to the output descriptor file
produced by the mmcrnsd command.
Upon successful completion of the mmcrnsd command, the DescFile file is rewritten to contain the
created NSD names in place of the device name. Primary and backup NSD servers and desiredName are
omitted from the rewritten disk descriptor and all other fields, if specified, are copied without modification.
The original lines, as well as descriptor lines in error, are commented out and preserved for reference. The
rewritten disk descriptor file can then be used as input to the mmcrfs, mmadddisk, or the mmrpldisk
commands. You must have write access to the directory where the DescFile file is located in order to
rewrite the created NSD information.
The Disk Usage and Failure Group specifications in the disk descriptor are preserved only if you use the
rewritten file produced by the mmcrnsd command. If you do not use this file, you must either accept the
default values or specify new values when creating disk descriptors for other commands.
Options
-v {yes |no}
Verify the disk is not already formatted as an NSD.
A value of -v yes specifies that the NSD are to be created only if the disk has not been formatted
by a previous invocation of the mmcrnsd command, as indicated by the NSD volume ID on sector
2 of the disk. A value of -v no specifies that the disk is to be formatted irrespective of its previous
state. The default is -v yes.
Exit status
0 Successful completion.
nonzero A failure has occurred.
Security
You must have root authority to run the mmcrnsd command.
You may issue the mmcrnsd command from any node in the GPFS cluster.
When using the rcp and rsh commands for remote communication, a properly configured .rhosts file must
exist in the root user’s home directory, on each node in the GPFS cluster. If you have designated the use
of a different remote communication program on either the mmcrcluster or the mmchcluster command,
you must ensure:
1. Proper authorization is granted to all nodes in the GPFS cluster.
2. The nodes in the GPFS cluster can communicate without the use of a password, and without any
extraneous messages.
Examples
To create your NSDs from the descriptor file nsdesc containing:
128 GPFS: Administration and Programming Reference