mmvdisk vdisk command

Lists individual IBM Storage Scale RAID vdisks.

Synopsis

mmvdisk vdisk list  [--vdisk-set {all | VsName[,VsName...]} [-Y]
or
mmvdisk vdisk list  --file-system FsName [-Y]
or
mmvdisk vdisk list  --recovery-group {all | RgName[,RgName...]}
                    [--vdisk-set {all | VsName[,VsName...]}]
                    [--declustered-array DaName[,DaName...]]
                    [--log] [-Y]
or
mmvdisk vdisk list  --vdisk VdiskName[,VdiskName...] [-Y]

Availability

Available on all IBM Storage Scale editions.

Description

Use the mmvdisk vdisk command to list individual IBM Storage Scale RAID vdisks.

Because mmvdisk administration of IBM Storage Scale RAID creates and deletes individual vdisks either as members of vdisk sets or as recovery group log vdisks, the mmvdisk vdisk command only supports the listing of individual vdisks.

Vdisks can be selected based on membership by vdisk set, by file system, or by recovery group and declustered array. Individual vdisks can also be listed by name.

By default, only user vdisks are listed - those vdisks that are in file systems or are eligible to be in file systems.

Log vdisks can be listed using the --log flag when a recovery group is specified.

Parameters

mmvdisk vdisk list
List selected individual vdisks.
--vdisk-set all | VsName[,VsName...]
Specifies the vdisk sets from which member vdisks are to be listed.
--file-system FsName
Specifies the file system from which vdisks are to be listed.
--recovery-group all | RgName[,RgName...]
Specifies the recovery groups from which vdisks are to be listed.
--declustered-array DaName[,DaName...]
Restricts the listing of recovery group vdisks to the specified declustered arrays. If omitted, vdisks are listed from all declustered arrays in a recovery group.
--log
Restricts the listing of recovery group vdisks to log vdisks. If omitted, only user vdisks are listed.
-Y
Specifies that the mmvdisk vdisk list command produce colon-delimited raw output.

Exit status

0
Successful completion.
nonzero
A failure occurred.

Security

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

Example

To list the user vdisks that are in file system FS3:

mmvdisk vdisk list --file-system FS3

The system displays output similar to the following:

                                                                 declustered array, RAID code,
vdisk               vdisk set       file system  recovery group            block size           remarks
------------------  --------------  -----------  --------------  -----------------------------  -------
RG001VS001          VS3             FS3          ESS01L          DA1, 8+3p, 8 MiB
RG002VS001          VS3             FS3          ESS01R          DA1, 8+3p, 8 MiB
RG003VS001          VS3             FS3          ESS02L          DA1, 8+3p, 8 MiB
RG004VS001          VS3             FS3          ESS02R          DA1, 8+3p, 8 MiB

Example

To list the log vdisks in recovery group ESS01L:

mmvdisk vdisk list --log --recovery-group ESS01L

The system displays output similar to the following:

                                                                 declustered array, RAID code,
vdisk               vdisk set       file system  recovery group            block size           remarks
------------------  --------------  -----------  --------------  -----------------------------  -------
RG001LOGHOME        -               -            ESS01L          DA1, 4WayReplication, 2 MiB    log home
RG001LLOGTIP        -               -            ESS01L          NVR, 2WayReplication, 2 MiB    log tip
RG001LLOGTIPBACKUP  -               -            ESS01L          SSD, Unreplicated, 2 MiB       log tip backup

See also

Location

/usr/lpp/mmfs/bin