ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • volume efficiency modify

    Modify the efficiency configuration of a volume

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

    Parameters

    -vserver <vserver name> - Vserver Name

    This specifies the Vserver on which the volume is located.

    { -volume <volume name> - Volume Name

    This specifies the volume on which efficiency options need to be modified.

    | -path </vol/volume> - Volume Path }

    This specifies the volume path on which efficiency options need to be modified.

    { [-schedule <text>] - Schedule

    This option is used to set and modify the schedule.

    schedule is [day_list][@hour_list] or [hour_list][@day_list] or - or auto or manual

    The day_list specifies the days of the week that an efficiency operation should run. It is a list of the first three letters of the day (sun, mon, tue, wed, thu, fri, sat), separated by a comma. Day ranges such as mon-fri can also be used. The default day_list is sun-sat. The names are not case sensitive.

    The hour_list specifies the hours of each scheduled day that an efficiency operation should run. The hour_list is from 0 to 23, separated by a comma. Hour ranges such as 8-17 are allowed. Step values can be used in conjunction with ranges (For example, 0-23/2 means every two hours in a day). The default hour_list is 0, i.e. at midnight of each scheduled day.

    When efficiency is enabled on a volume for the first time, an initial schedule is assigned to the volume. This initial schedule is sun-sat@0, which means run once every day at midnight.

    If "-" is specified, no schedule is set on the volume. The auto schedule string triggers an efficiency operation depending on the amount of new data written to the volume. The manual schedule string prevents SIS from automatically triggering any operations and disables change-logging. This schedule string can only be used on SnapVault destination volumes. The use of this schedule is mainly desirable when inline compression is enabled on a SnapVault destination volume and background processing is not necessary.

    Note that schedule and policy are mutually exclusive options.

    | [-policy <text>] - Efficiency Policy Name }

    This option is used to set an efficiency policy. The policy cannot be changed to the predefined inline-only policy when there is an active background operation on the volume.

    Note that schedule and policy are mutually exclusive options.

    { [-compression {true|false}] - Compression

    This option is used to enable and disable compression. The default value is determined based on the platform.

    [-inline-compression {true|false}] - Inline Compression

    This option is used to enable and disable inline compression. Inline compression can be enabled only if compression is enabled. The default value is determined based on the platform.

    You can use the inline-only predefined efficiency policy to run inline compression without the need of any background efficiency operations.

    [-compression-type {none|secondary|adaptive}] - Compression Type

    This option is used to specify the size of compression group on the volume. The default value is determined based on the platform.

    | [-storage-efficiency-mode {default|efficient}] - Storage Efficiency Mode }

    This option is used to modify the storage efficiency mode. The default mode sets 8k adaptive compression on the volume. The efficient mode sets auto adaptive compression and attempts to enable inline deduplication, cross volume inline deduplication and cross volume background deduplication on the volume.

    The available efficiency modes are:

    • default

    • efficient

    [-inline-dedupe {true|false}] - Inline Dedupe

    This option is used to enable and disable inline deduplication. The default value is determined based on the platform.

    You can use the inline-only predefined efficiency policy to run inline deduplication without the need of any background efficiency operations.

    [-data-compaction {true|false}] - Data Compaction

    This option is used to enable and disable data compaction. The default value is determined based on the platform.

    [-cross-volume-inline-dedupe {true|false}] - Cross Volume Inline Deduplication

    This option is used to enable and disable cross volume inline deduplication. The default value is determined based on the platform.

    [-cross-volume-background-dedupe {true|false}] - Cross Volume Background Deduplication

    This option is used to enable and disable cross volume background deduplication. The default value is determined based on the platform.

    Examples

    The following examples modify efficiency options on a volume.

    cluster1::> volume efficiency modify -vserver vs1 -volume vol1 -schedule sun-sat@12
    cluster1::> volume efficiency modify -vserver vs1 -volume vol1 -policy policy1
    cluster1::> volume efficiency modify -vserver vs1 -volume vol1 -compression true -inline-compression true -inline-dedupe true -data-compaction true -cross-volume-inline-dedupe true -cross-volume-background-dedupe true
    Top of Page