Skip to main content
A newer release of this product is available.

volume create

Contributors
Suggest changes

Create a new volume

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The volume create command creates a volume on a specified Vserver and storage aggregates. You can optionally specify the following attributes for the new volume:

  • Size

  • State (online, offline, or restricted)

  • Type (read-write or data-protection)

  • Export policy

  • User ID

  • Group ID

  • Security style (All volume types: UNIX mode bits, CIFS ACLs, or mixed NFS and CIFS permissions.)

  • Default UNIX permissions for files on the volume

  • Language

  • Junction path

  • Whether the junction path is active (advanced privilege level or higher only)

  • Whether the volume is the root volume for its Vserver (advanced privilege level or higher only)

  • Comment

  • Whether autosizing is enabled for FlexVols

  • Maximum size for autosizing FlexVols

  • Minimum size for autosize

  • Grow used space threshold percentage for autosize

  • Shrink used space threshold percentage for autosize

  • Whether autosizing is enabled for FlexVols

  • Current mode of operation of volume autosize

  • Maximum directory size (advanced privilege level or higher only)

  • Space guarantee style (none or volume)

  • Space SLO type (none, thick or semi-thick)

  • Snapshot policy

  • Snapshot reserve percentage

  • Use logical space reporting

  • Use logical space enforcement

  • Whether the volume create operation runs as a foreground or background process

  • Caching policy

  • Encrypt

  • Cache retention priority

  • Efficiency policy

  • Tiering minimum cooling days

Parameters

-vserver <vserver name> - Vserver Name

This specifies the Vserver on which the volume is located. If only one data Vserver exists, you do not need to specify this parameter.

-volume <volume name> - Volume Name

This specifies the name of the volume that is to be created. A volume's name must start with an alphabetic character (a to z or A to Z) and be 197 or fewer characters in length for FlexGroups, and 203 or fewer characters in length for all other volume types. Volume names must be unique within a Vserver.

{ -aggregate <aggregate name> - Aggregate Name

This specifies the storage aggregate on which the volume is to be created. This parameter only applies to FlexVol volumes.

| -aggr-list <aggregate name>,…​ - List of Aggregates for FlexGroup Constituents

Specifies an array of names of aggregates to be used for FlexGroup constituents. Each entry in the list will create a constituent on the specified aggregate. An aggregate may be specified multiple times to have multiple constituents created on it. This parameter only applies to FlexGroups.

[-aggr-list-multiplier <integer>] - Aggregate List Repeat Count

Specifies the number of times to iterate over the aggregates listed with the -aggr-list parameter when creating a FlexGroup. The aggregate list will be repeated the specified number of times. Example:

-aggr-list aggr1,aggr2 -aggr-list-multiplier 2

will cause four constituents to be created in the order aggr1 , aggr2 , aggr1 , aggr2 .

+
The default value is 4.

+
This parameter only applies to FlexGroups

| -auto-provision-as <FlexGroup> - Automatically Provision as Volume of Type

Use this parameter to automatically select existing aggregates for provisioning FlexGroup volumes. Note that the fastest aggregate type with at least one aggregate on each node of the cluster will be selected. When auto provisioning a FlexGroup volume, the size of the FlexGroup volume should be a minimum of 800 GB per node.

This parameter only applies to FlexGroups.

[-support-tiering {true|false}] - Automatically Provision FlexGroup on FabricPools

This parameter specifies whether or not FabricPools are selected when provisioning a FlexGroup during the protection workflows using the auto-provision-as parameter. Only FabricPool aggregates are used if this parameter is set to true and only non FabricPool aggregates are used if this parameter is set to false. Tiering support for a FlexGroup can be changed by moving all of the constituents to the required aggregates. The default value is false

This parameter only applies to FlexGroups created using the -auto-provision-as parameter.

[-use-mirrored-aggregates {true|false}] - Automatically Provision FlexGroup on Mirrored Aggregates

Use this parameter to specify whether mirrored aggregates are selected when creating a FlexGroup using the auto-provision-as parameter. Only mirrored aggregates are used if this parameter is set to true and only unmirrored aggregates are used if this parameter is set to false. Aggregate level mirroring for a FlexGroup can be changed by moving all of the constituents to the required aggregates. The default value is true for a MetroCluster configuration and is false for a non-MetroCluster configuration

This parameter only applies to FlexGroups created using the -auto-provision-as parameter.

[-encryption-type {none|volume|aggregate}] - Encryption Type

Use this parameter to specify the encryption-type while creating a FlexGroup using the auto-provision-as parameter. If the value is none , the FlexGroup created will be unencrypted. If t