Skip to main content

volume flexgroup deploy

Suggest changes

Deploy a FlexGroup on the cluster

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


The volume flexgroup deploy command deploys a FlexGroup on the cluster.

The FlexGroup is created with 8 constituents on each node in the cluster. The constituents are split equally between the two largest aggregates on each node. If using two aggregates per node is not possible, all of the constituents are created on the largest aggregate on each node.

The volume flexgroup deploy command is only supported on clusters with 4 nodes or less. On clusters with more than 4 nodes, use the volume create command to create FlexGroups.


-vserver <vserver name> - Vserver Name

This specifies the Vserver on which the FlexGroup will be located.

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

This specifies the size of the FlexGroup. The size is specified as a number followed by a unit designation: k (kilobytes), m (megabytes), g (gigabytes), t (terabytes), or p (petabytes). 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 is 160 MB multiplied by the number of nodes in the cluster. The maximum size of the FlexGroup is limited by the platform maximum FlexVol size multiplied by 8 and multiplied by the number of nodes in the cluster. The size of the FlexGroup is also limited by the available space in the hosting aggregates. FlexGroups can be increased in size with the volume modify command and more constituents can be added with the volume expand command.

[-volume <volume name>] - Name of the FlexGroup to Create

This specifies the name of the FlexGroup. The name of the FlexGroup must start with an alphabetic character (a to z or A to Z) and must have 197 or fewer characters. The default value for the FlexGroup name is "fg".

[-type {RW|DP}] - Volume Type

This optionally specifies the FlexGroup's type, either read-write (RW) or data-protection (DP). If you do not specify a value for this parameter, a RW volume is created by default.

[-space-guarantee {none|volume}] - Space Guarantee Style

This optionally specifies the space guarantee style for the FlexGroup. A value of volume reserves space on the aggregates for the entire volume. A value of none reserves no space on the aggregates, meaning that writes can fail if an aggregate runs out of space. Because CIFS does not handle out-of-space conditions, do not use the value none if the volume is accessible to CIFS clients. The default setting for volumes on All Flash FAS systems is none , otherwise the default setting is volume .

[-foreground {true|false}] - Foreground Process

If this parameter is specified with false , the command runs in the background as a job. Otherwise, the command does not return until the operation is complete. The default value is true


The following example deploys a FlexGroup named "flexgroup" in the Vserver named "":

cluster::> volume flexgroup deploy -size 400TB -vserver -volume flexgroup