volume efficiency policy create

Create an efficiency policy

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


The volume efficiency policy create creates an efficiency policy.


-vserver <vserver name> - Vserver
Specifies the Vserver on which the volume is located.
-policy <text> - Efficiency Policy Name
This specifies the policy name.
[-type <Efficiency policy type>] - Policy Type
This specifies the policy type. The policy type defines when the volume using this policy will start processing a changelog. There are two possible values:
  • threshold means changelog processing occurs when the changelog reaches a certain percentage.
  • scheduled means changelog processing will be triggered by time.
The default value is scheduled.
[-schedule <text>] - Job Schedule Name
This specifies the job schedule. Use job schedule commands to manage job schedules. Only cron job schedules are supported.
[-duration <text>] - Duration
This specifies the duration that an efficiency operation can run (in hours). The possible values are "-" or a number between 1 and 999 inclusive. Default value is "-", which means no duration.
[-start-threshold-percent <percent>] - Threshold Percentage
The percentage at which the changelog will be processed. The percentage is checked on an hourly basis. The default value is 20. Valid only if -type parameter is set as threshold.
[-qos-policy <Efficiency QoS policy>] - QoS Policy
This specifies how the efficiency operations are throttled. This option can be configured to be background or best-effort. Default value is best-effort. If background is specified, the efficiency operations are run with minimum or no impact on the data serving client operations. If best-effort is specified, the efficiency operations might have some impact on the data serving client operations.
[-enabled {true|false}] - Enabled
This specifies whether the policy is enabled or not. The policy is enabled by default.
[-comment <text>] - Comment
User specified comment.


The following example creates an efficiency policy.
cluster1::> volume efficiency policy create -vserver vs1 -policy policy1 -schedule daily -duration 100