mmvdisk vdiskset command

Availability

Available on all IBM Spectrum Scale editions.

Description

Use the mmvdisk vdiskset command to define, size, or create uniform vdisk NSDs across IBM Spectrum Scale RAID recovery groups. The vdisk sets that result can then be used as units in constructing IBM Spectrum Scale file systems.

With mmvdisk commands, user vdisks are managed collectively into vdisk sets that contain vdisk NSDs with identical attributes from one or more recovery groups. Each recovery group contributes one member vdisk NSD to the vdisk set. To create a file system that is balanced across several recovery groups, define a vdisk set that uses those recovery groups.

The vdisk set definition provides a preview of the sizing impact of the vdisk set on the recovery groups and the servers. If the sizing is acceptable, the vdisk set can be created. This means that the individual member vdisks and NSDs in each recovery group are all created. The vdisk set can be used to create an IBM Spectrum Scale RAID file system or added to an existing IBM Spectrum Scale RAID file system.All member vdisk NSDs that are part of a vdisk set must belong to the same file system. A file system can contain one or more vdisk sets.

Use the mmvdisk vdiskset define command to define vdisk sets or to add a recovery group to an existing vdisk set definition.

When multiple recovery groups are used in an initial vdisk set definition, the declustered arrays must have compatible characteristics (such as number of pdisks, number of spare pdisks, or pdisk hardware type). This ensures that the member vdisk NSDs in the vdisk set have the same characteristics.

To add recovery groups to an existing vdisk set definition, use mmvdisk vdiskset define with only the --vdisk-set and --recovery-group parameters. The declustered array in the added recovery groups must be compatible with the declustered array that was used in the initial vdisk set definition. In carefully considered circumstances, it might be possible to force a vdisk set definition into an incompatible declustered array by using the --force-incompatible parameter.

When a vdisk set is defined, mmvdisk shows the space that is used by the definition in both the declustered array and in the recovery group server memory. This permits the administrator to evaluate the definition in context before you commit to its creation, or deciding to undefine it and try a different definition.

A vdisk set can be undefined by using the mmvdisk vdiskset undefine command. Use this to remove individual recovery groups from a vdisk set, or to remove the entire vdisk set definition. Any member vdisk NSDs in the affected recovery groups must first be deleted by using the mmvdisk vdiskset delete command.

The member vdisk NSDs of a vdisk set definition are created by using the mmvdisk vdiskset create command. A vdisk set is created when all the actual member vdisk NSDs exist in each recovery group in the vdisk set definition. The mmvdisk vdiskset create command creates only those vdisk NSDs that do not exist. This permits a vdisk set to be defined and created, then to have another recovery group added and to create only the vdisk NSDs in the added recovery group. Only created vdisk sets can be used with the mmvdisk filesystem command to add to or create IBM Spectrum Scale RAID file systems.

Member vdisk NSDs can be deleted from a vdisk set by using the mmvdisk vdiskset delete command. The member vdisk NSDs to be deleted might be limited to a recovery group, or might include the entire vdisk set. In either case, it is not permitted to delete member vdisk NSDs that are in a file system.

Use the mmvdisk vdiskset rename command to change the name of a vdisk set. This is useful for giving meaningful names to the vdisk sets defined by the mmvdisk recoverygroup convert command.

Use the mmvdisk vdiskset list command to list vdisk sets and to show their attributes and sizing.

Parameters

mmvdisk vdiskset define

Define vdisk sets across IBM Spectrum Scale RAID recovery groups.

mmvdisk vdiskset undefine

Removes vdisk set definitions from IBM Spectrum Scale RAID recovery groups.

mmvdisk vdiskset create

Creates member vdisk NSDs for a vdisk set.

mmvdisk vdiskset delete

Deletes member vdisk NSDs from a vdisk set. The member vdisk NSDs must not belong to a file system.

mmvdisk vdiskset rename

Renames a vdisk set.

mmvdisk vdiskset list

Lists vdisk sets and shows their attributes and sizing.

--vdisk-set VsName

Specifies a single vdisk set to define, undefine, or rename.

--vdisk-set {all | VdiskSet[,VdiskSet...]}

Specifies vdisk sets to create, delete, or list.

--recovery-group all | RgName[,RgName...]

Specifies recovery groups in which vdisk sets are to be defined or listed.

--recovery-group RgName[,RgName...]

Specifies recovery groups from which vdisk NSDs are to be deleted, or in which a vdisk set is to be defined or undefined.

--code RaidCode

Specifies the IBM Spectrum Scale RAID code for a vdisk set definition.

--block-size BlockSize

Specifies the block size of a vdisk set definition.

--set-size SetSize

Specifies the set size (within a single recovery group) of a vdisk set definition.

--declustered-array DaName

Specifies the declustered array of a vdisk set definition.

--nsd-usage NsdUsage

Specifies the file system NSD usage of a vdisk set definition.

--storage-pool Pool

Specifies the file system storage pool of a vdisk set definition.

--force-incompatible

When extending a vdisk set definition to additional recovery groups, attempts to ignore incompatible declustered array characteristics.

Attention: This parameter should be used only under careful consideration.

--new-name NewName

Specifies the new name for a vdisk set (when used with the mmvdisk vdiskset rename command).

--declustered-array DaName[,DaName...]

Chooses the declustered arrays in which vdisk sets are to be listed (when used with the mmvdisk vdiskset list command).

--file-system {all | FsName[,FsName...]}

Chooses file systems from which vdisk sets are to be listed (when used with the mmvdisk vdiskset list command).

--confirm

Confirms the removal of a vdisk set definition. This flag bypasses the interactive prompt that would otherwise be printed to confirm undefining a vdisk set.

-p

Indicates that the member vdisk NSDs are in a recovery group that is permanently damaged and must be deleted without access to the recovery group (when used with the mmvdisk recoverygroup delete command) . You cannot use this parameter if the recovery group is active.

Attention: This is an unusual maintenance case that should only be performed under the direction of the IBM Service team.

Before a vdisk set can be deleted using -p, the vdisk set must be deleted from any file system.

-Y

Specifies that the mmvdisk vdiskset 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 vdiskset 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 more information, see the following IBM Spectrum Scale RAID: Administration topic: Requirements for administering IBM Spectrum Scale RAID.

See also

Location