Skip to main content

volume expand

Expand the size of a volume by adding constituents

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

Description​

The volume expand command allows the user to increase the size of a FlexGroup by adding constituents. The size of the new constituents is determined by the size of the smallest existing constituent. This command only applies to FlexGroups.

Parameters​

-vserver <vserver name> - Vserver Name
This parameter can be used to specify the Vserver on which the volume is located.
-volume <volume name> - Volume Name
This parameter specifies the volume for which the user wants to expand.
-aggr-list <aggregate name>, ... - List of Aggregates for FlexGroup Constituents
Specifies an array of names of aggregates to be used for new 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.
[-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 expanding 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 1.
[-foreground {true|false}] - Foreground Process
If false is specified for this parameter, the command runs as a job in the background. If true is specified, the command will not return until the operation is complete. The default value is true.

Examples​

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

-aggr-list aggr1,aggr2 -aggr-list-multiplier 2
The following example increases the size of a FlexGroup by adding 3 constituents:
      cluster1::> volume show -vserver vs1 -volume flexgroup -fields size
      vserver volume    size
      ------- --------- -----
      vs1     flexgroup 180TB
      
      cluster1::> volume expand -vserver vs1 -volume flexgroup -aggr-list aggr1,aggr2,aggr3

      Warning: The following number of constituents of size 20TB will be added to
      FlexGroup "flexgroup": 3. Expanding the FlexGroup will cause the state of
      all Snapshot copies to be set to "partial". Partial Snapshot copies
      cannot be restored.
      Do you want to continue? [y|n]: y
      [Job 52] Job succeeded: Successful
      
      cluster1::> volume show -vserver vs1 -volume flexgroup -fields size
      vserver volume    size
      ------- --------- -----
      vs1     flexgroup 240TB
The following example increase the size of a FlexGroup by adding 6 constituents using the -aggr-list-multiplier:
      cluster1::> volume show -vserver vs1 -volume flexgroup -fields size
      vserver volume    size
      ------- --------- -----
      vs1     flexgroup 240TB
      
      cluster1::> volume expand -vserver vs1 -volume flexgroup -aggr-list aggr1,aggr2 -aggr-list-multiplier 3

      Warning: The following number of constituents of size 20TB will be added to
      FlexGroup "flexgroup": 6. Expanding the FlexGroup will cause the state of
      all Snapshot copies to be set to "partial". Partial Snapshot copies
      cannot be restored.
      Do you want to continue? [y|n]: y
      [Job 53] Job succeeded: Successful
      
      cluster1::> volume show -vserver vs1 -volume flexgroup -fields size
      vserver volume    size
      ------- --------- -----
      vs1     flexgroup 360TB