volume efficiency modify

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

Description

This command is used to set or modify the schedule, policy and various other efficiency configuration options on a volume. This command is not supported on FlexGroups, FlexGroup constituents, or Infinite Volumes that are managed by storage services.

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-type {none|secondary|adaptive}] - Compression Type (privilege: advanced)

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

[-compression {true|false}] - Compression

This option is used to enable and disable compression. The default value is false.

[-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 false.

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

[-idd {true|false}] - (DEPRECATED)-Incompressible Data Detection

Note: This parameter is deprecated and may be removed in a future release of Data ONTAP.

This option is used to enable and disable incompressible data detection. It can be enabled only if compression is enabled. The default value is false.

[-quick-check-fsize <integer>] - (DEPRECATED)-Compression Quick Check File Size

Note: This parameter is deprecated and may be removed in a future release of Data ONTAP.

This option is used to modify the minimum file size (in bytes) required to attempt Quick check on a file. The default value is 500MB.

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

This option is used to enable and disable inline deduplication. The default value is false.

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 false.

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 -idd true -inline-dedupe true -data-compaction true