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