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.

Description

This command is used to set or modify the schedule, policy and various other efficiency configuration options on a volume.

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