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.

[-nodes {<nodename>|local}] - List of Nodes Hosting the Volume }

Specifies an array of node names to be used for provisioning the FlexGroup. If an array of node names is specified, only aggregates from the specified nodes will be considered for provisioning. If no value is specified, all nodes in the cluster will be used.

[-size {<integer>[KB|MB|GB|TB|PB]}] - Volume Size

This optionally specifies the size of the volume. The size is specified as a number followed by a unit designation: k (kilobytes), m (megabytes), g (gigabytes), or t (terabytes). If the unit designation is not specified, bytes are used as the unit, and the specified number is rounded up to the nearest 4 KB. The minimum size for a FlexVol volume is 20 MB. The minimum size for a volume guaranteed FlexGroup is 20 MB per constituent. The minimum size for a none guaranteed FlexGroup is 200 MB per constituent. However, the recommended size for all FlexGroups is a minimum of 100 GB per constituent. For all volumes, the default size is set to the minimum size. The volume's maximum size is limited by the platform maximum. If the volume's guarantee is set to volume , the volume's maximum size can also be limited by the available space in the hosting aggregates. Volumes can be increased and decreased in size with the volume modify command. The maximum number of files a volume is configured for is listed under "Total Files" when running the command volume show-instance .

[-state {online|restricted|offline|force-online|force-offline|mixed}] - Volume State

This optionally specifies the volume's state. A restricted volume does not provide client access to data but is available for administrative operations.

Note The mixed state applies to FlexGroups only and cannot be specified as a target state.
[-policy <text>] - Export Policy

This optionally specifies the ID number of the export policy associated with the volume. For information on export policies, see the documentation for the vserver export-policy create command. FlexGroups do not support policies that allow NFSv4 protocol access.

[-user <user name>] - User ID

This optionally specifies the name or ID of the user that is set as the owner of the volume's root.

[-group <group name>] - Group ID

This optionally specifies the name or ID of the group that is set as the owner of the volume's root.

[-security-style <security style>] - Security Style

This optionally specifies the security style for the volume. Possible values include unix (for UNIX mode bits), ntfs (for CIFS ACLs), mixed (for mixed NFS and CIFS permissions) and unified (for mixed NFS and CIFS permissions with unified ACLs). Regardless of the security style, both NFS and CIFS clients can read from and write to the volume.

<