ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • 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

    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
    Top of Page