Skip to main content

volume efficiency policy create

Contributors
Suggest changes
PDFs

Create an efficiency policy

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

Description

The volume efficiency policy create creates an efficiency policy.

Parameters

-vserver <vserver name> - Vserver

Specifies the Vserver on which the volume is located.

-policy <text> - Efficiency Policy Name

This specifies the policy name.

[-type {threshold|scheduled}] - 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 {background|best_effort}] - 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.

Examples

The following example creates an efficiency policy.

cluster1::> volume efficiency policy create -vserver vs1 -policy policy1 -schedule daily -duration 100