mmvdisk nsd command

Manages an IBM Storage Scale non-vdisk NSD for IBM Storage Scale RAID.

Synopsis

mmvdisk nsd create --disk-list DiskExpr [--usage NSDUsage]
                    [--pool StoragePool] [-v {yes|no}]
                    [-N Node[,Node ...] | --node-class nodeClass]
                    [--protection-information {yes|no}]
or
mmvdisk nsd replace --prepare --nsd nsdName
or 
mmvdisk nsd replace --nsd nsdName [-v {yes|no}]
or 
mmvdisk nsd replace --cancel --nsd nsdName
or 
mmvdisk nsd replace [--protection-information {yes|no}]
or 
mmvdisk nsd change --nsd {nsdName[,nsdName ...] | all} --register

Availability

Available on all IBM Storage Scale editions.

Description

Use the mmvdisk nsd command to manage an IBM Storage Scale non-vdisk NSD.

Use the mmvdisk nsd create command to create an IBM Storage Scale non-vdisk NSD.

Use the mmvdisk nsd replace command to perform NSD replacement when it needs service.

Complete the following steps to replace an NSD:
  1. Run the mmvdisk nsd replace --prepare command to prepare the NSD for physical removal.
  2. Physically remove the disk and replace it with a new disk of the same type.
  3. Run the mmvdisk nsd replace command to complete the replacement.

Use the mmvdisk nsd change command to update slot information of IBM Storage Scale non-vdisk NSD.

Parameters

mmvdisk nsd create
Create an IBM Storage Scale non-vdisk NSD.
mmvdisk nsd replace
Replaces an IBM Storage Scale non-vdisk NSD when the disk needs service.
mmvdisk nsd change
Changes property of an IBM Storage Scale non-vdisk NSD.
--node-class nodeClass
Specifies a class name of a single mmvdisk node to be created for an IBM Storage Scale non-vdisk NSD.
--protection-information {yes | no}
By using the mmvdisk nsd create command, this option can be used to enable or disable the protection information feature on NVMe devices. This command automatically format the drives, if needed.
By using the mmvdisk pdisk replace command, this option can be used to enable or disable the protection information feature on the replacement NVMe device. This option only takes place when the original NSD drive had no previous format information present in mmvdisk. Otherwise, you need to use an NSD drive that matches with the original drive format.
Note: If the --protection-information option is not specified, mmvdisk does not check the NVMe device format.
  • Before you use this option NVMe, check whether the device has an NSD or a pdisk descriptor. Use the -v no option to ignore this check.
  • Before you create an NSD, mmvdisk checks whether NVMe devices specified by using the --disk-list option have the same format. For example, if an NVMe is formatted with 4k+8 and other disks are formatted with 512+8, these drives are not accepted.
-N Node[,Node...]
Specifies individual nodes to be created for an IBM Storage Scale non-vdisk NSD.
--disk-list DiskExpr
With the mmvdisk nsd create commands, the --disk-list option specifies the disk list that to be used for creating an IBM Storage Scale non-vdisk NSD. For more information, see the mmvdisk recoverygroup command.
--usage NSDUsage
Specifies the file system NSD usage.
--pool
Specifies a storage poof of the file system NSD.
-v {yes|no}
With the mmvdisk nsd create command, verify that the disks are not already formatted as an NSD.
--prepare
With the mmvdisk pdisk replace command, prepares an NSD for removal and replacement.
--cancel
With the mmvdisk pdisk replace command, cancels the preparation of a pdisk for removal and replacement.
--nsd nsdName
Specifies an NSD name.
--register
With the mmvdisk nsd change command, register any missing associations between an NSD and its slot information in CCR.

Exit status

0
Successful completion.
nonzero
A failure occurred.

Security

You must have root authority to run the mmvdisk nsd 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.

Example

  1. To create an IBM Storage Scale non-vdisk NSD, issue the following command:
    mmvdisk nsd create --disk-list 78E4001-[7-12,19-24] --usage dataOnly --pool perf_pool --nc nc3500
    A sample output is as follows:
    mmvdisk: (mmcrnsd) Processing disk nvme16n1
mmvdisk: (mmcrnsd) Processing disk nvme23n1
mmvdisk: (mmcrnsd) Processing disk nvme17n1
mmvdisk: (mmcrnsd) Processing disk nvme24n1
mmvdisk: (mmcrnsd) Processing disk nvme18n1
mmvdisk: (mmcrnsd) Processing disk nvme25n1
mmvdisk: (mmcrnsd) Processing disk nvme8n1
mmvdisk: (mmcrnsd) Processing disk nvme2n1
mmvdisk: (mmcrnsd) Processing disk nvme7n1
mmvdisk: (mmcrnsd) Processing disk nvme1n1
mmvdisk: (mmcrnsd) Processing disk nvme6n1
mmvdisk: (mmcrnsd) Processing disk nvme0n1
mmvdisk: Created nsd 'E78E4001S07;E78E4001S08;E78E4001S09;E78E4001S10;E78E4001S11;E78E4001S12;E78E4001S19;E78E4001S20;E78E4001S21;E78E4001S22;E78E4001S23;E78E4001S24' successfully.
  2. To prepare for an NSD replacement, issue the following command:
    mmvdisk nsd replace --prepare --nsd E78E4001S11
    A sample output is as follows:
    mmvdisk: Prepare replace NSD disk:
mmvdisk:  - Replace disk in location 78E4001-11 with new disk.
mmvdisk:  - Issue the folliwng command:
mmvdisk:
mmvdisk:  mmvdisk nsd replace --nsd E78E4001S11
  3. After a new disk is inserted in a corresponding slot, replace the NSD:
    mmvdisk nsd replace --nsd E78E4001S11 -v no
    A sample output is as follows:
    mmvdisk: (mmcrnsd) Processing disk nvme18n2
mmvdisk: Completed replacing NSD 'E78E4001S11'.

See also

Location

/usr/lpp/mmfs/bin