6.2.12.19 mkvolumegroup

Create a volume group.

Purpose

The mkvolumegroup command creates a volume group.

Syntax

mkvolumegroup [ volume-group-name ] 
              [ --attributes attribute=value[,attribute=value]... ]

Command Options

The command options for the mkvolumegroup command are:

  • volume-group-name: Specifies the name of the volume group.

    If the name is not specified here, it must be specified as an attribute setting.

  • --attributes: Specifies attributes settings for the volume group:

    • name: Specifies the name of the volume group.

      If the name is not specified as an attribute setting, it must be specified as the first argument of the mkvolumegroup command.

    • resourceSharing: Optionally specifies how provisioned resources are shared by volumes in the group. The default value is none. Permitted values are:

      • aggregate: Configures the volume group to share the I/Os per second (IOPS) bandwidth provisioned to each volume in the group. In this case, a volume can exceed its provisioned limit by sharing unused IOPS provisioned to other volumes in the group.

        For example, consider a group with two volumes that are provisioned with 1000 IOPS each. In this example, aggregate resource sharing enables one volume to use 2000 IOPS when the other volume is idle.

      • specified: Configures the volume group to share the I/Os per second (IOPS) bandwidth limit specified by the iopsProvisioned attribute.

      • none: Specifies that the volume group is not a resource-sharing volume group. In this case, each volume is only subject to resource limits imposed at other levels, such as the individual volume level or the Exascale vault level.

    • iopsProvisioned: Optionally specifies the I/O bandwidth limit provisioned to the volume group, expressed in I/Os per second (IOPS). The default value is 0.

Usage Notes

  • When resource sharing is disabled on a volume group (resourceSharing=none), the I/O bandwidth provisioned to the volume group must be zero (iopsProvisioned=0).

  • When a volume group uses aggregate resource sharing (resourceSharing=aggregate), the I/O bandwidth provisioned to the volume group must be zero (iopsProvisioned=0).

  • When a volume group employs specified resource sharing (resourceSharing=specified), the iopsProvisioned attribute value must be greater than zero.

Examples

Example 6-182 Create a Volume Group

These examples show how to create volume groups with the specified names and other attribute settings.

@> mkvolumegroup vol-group1 --attributes resourceShareing=specified,iopsProvisioned=1000
@> mkvolumegroup --attributes name=vol-group2,resourceShare=aggregate

Parent topic: Block Store Management