Create volume in disk pool

The create volume diskPool command creates a new standard RAID volume or a thin volume in an existing disk pool.

Supported Arrays

This command applies to an individual DE2000H, DE4000H, DE4000F, DE6000H, or DE6000F storage array.

Roles

To execute this command on an storage array, you must have the Storage Admin role.

Context

Note: Some parameters for creating a standard RAID volume in a volume group are not compatible for creating volumes of any type in a disk pool. When using older scripts to create volumes in disk pools, make sure that all of the parameters are valid for disk pools. Invalid parameters prevent the scripts from running correctly and cause an error to be posted.

Syntax for Creating a Standard Volume

create volume diskPool="diskPoolName" 
userLabel="volumeName" 
capacity=volumeCapacity 
[thinProvisioned=(TRUE | FALSE)] 
[owner=(a|b)] 
[mapping=(none|default)] 
[dataAssurance=(none|enabled)] 
[cacheReadPrefetch=(TRUE | FALSE)]

Syntax for Creating a Thin Provisioned Volume

create volume diskPool="diskPoolName" 
userLabel="volumeName" 
capacity=volumeCapacity 
[thinProvisioned=(TRUE | FALSE)] 
[owner=(a|b)] 
[mapping=(none|default)] 
[dataAssurance=(none|enabled)] 
[(existingRepositoryLabel=existingRepositoryName | 
[newRepositoryCapacity=newRepositoryCapacityValue (KB | MB | GB | TB | Bytes)] 
[repositoryMaxCapacity=repositoryMaxCapacityValue(KB|MB|GB|TB|Bytes)] 
[warningThresholdPercent=warningThresholdPercentValue] 
[repositoryExpansionPolicy=(automatic|manual)] 
[cacheReadPrefetch=(TRUE | FALSE)]

Parameters

Parameter Description
diskPool The name of the disk pool in which to create the new volume. Enclose the disk pool name in double quotation marks (" ").
userLabel The name that you want to give the new volume. Enclose the volume name in double quotation marks (" ").
capacity

The size of the volume that you are creating.

For a standard RAID volume, the capacity that will be allocated for the volume.

For a thin volume, the virtual capacity value that will be exposed by the thin volume.

Size is defined in units of bytes , KB , MB , GB , or TB . The following are examples of the syntax:
  • capacity=500MB
  • capacity=2GB
thinProvisioned

This parameter enables thin provisioning for the new volume. To use thin provisioning, set this parameter to TRUE . If you do not want thin provisioning, set this parameter to FALSE .

owner

The controller that owns the volume. Valid controller identifiers are a or b , where a is the controller in slot A , and b is the controller in slot B . If you do not specify an owner, the controller firmware determines the owner.

mapping

This parameter enables you to map the volume to a host. If you want to map later, set this parameter to none . If you want to map now, set this parameter to default . The volume is mapped to all hosts that have access to the storage pool.

The default value is none .

existingRepositoryLabel This parameter identifies an existing repository for a thin volume. A repository volume has the physical capacity for a thin volume. This parameter applies only for thin provisioning. If you use the existingRepositoryLabel parameter, you must not use the newRepositoryCapacity parameter.
newRepositoryCapacity

This parameter creates a new repository for a thin volume. A repository volume has the physical capacity for a thin volume. Use this parameter only if you set the value of the thinProvisioned parameter to TRUE .

Size is defined in units of MB , GB , or TB . The following are examples of the syntax:
  • capacity=500MB
  • capacity=2GB

The default value is 50 percent of the virtual capacity.

repositoryMaxCapacity

This parameter defines the maximum capacity for a repository for a thin volume. Use this parameter only if you se the value of the thinProvisioned parameter to TRUE .

Size is defined in units of MB , GB , or TB . The following are examples of the syntax:
  • capacity=500MB
  • capacity=2GB
warningThresholdPercent

The percentage of thin volume capacity at which you receive a warning alert that the thin volume is nearing full. Use integer values. For example, a value of 70 means 70 percent.

Valid values are from 1 to 100.

Setting this parameter to 100 disables warning alerts.

repositoryExpansionPolicy This parameter sets the expansion policy to automatic or manual . When you change the policy from automatic to manual , the maximum capacity value (quota) changes to the physical capacity of the repository volume.
cacheReadPrefetch The setting to turn on or turn off cache read prefetch. To turn off cache read prefetch, set this parameter to FALSE . To turn on cache read prefetch, set this parameter to TRUE .

Notes

Each volume name must be unique. You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the user label. User labels can have a maximum of 30 characters.

For thin volumes, the capacity parameter specifies the virtual capacity of the volume, and the repositoryCapacity parameter specifies the capacity of the volume created as the repository volume. Use the existingRepositoryLabel parameter to specify an existing unused repository volume instead of creating a new volume.

For best results when creating a thin volume, the repository volume must already exist or must be created in an already existing disk pool. If you do not specify some of the optional parameters when creating thin volumes the storage management software will attempt to create the repository volume. The most desirable candidate volume is a repository volume that already exists and that is within the size requirements. The next most desirable candidate volume is a new repository volume that is created in the disk pool free extent.

Repository volumes for thin volumes cannot be created in volume groups.