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

-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