Skip to main content

volume efficiency policy show

Contributors
Suggest changes

Show efficiency policies

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

Description

The volume efficiency policy show command displays information about efficiency policies. By default, the command displays the following information about all policies:

  • Vserver: Name of the Vserver that the policy belongs to.

  • Policy Name: Efficiency policy name.

  • Job Schedule: Job schedule name.

  • Duration (Hours): The duration in hours that the efficiency operation can run.

  • Enable: Whether the policy is enabled or not.

  • Comment: User specified comment.

You can specify additional parameters to select the displayed information. For example, to display efficiency policies only with duration 5 hours, run the command with the -duration 5 parameter.

The pre-defined policies default and inline-only are available when all the nodes in the cluster are running Data ONTAP version 8.3 or later.

The inline-only pre-defined policy must be used when the user wants to use the inline compression feature without any regularly scheduled or manually started background storage efficiency operations. When a volume is configured to use the inline-only efficiency policy, the system will stop monitoring changes to the data for running the background efficiency operations on the volume. Volumes cannot be configured with the inline-only policy if there is a currently active background efficiency operation.

Parameters

{ [-fields <fieldname>,…​]

Selects the fields to be displayed. Vserver and policy are the default fields (see example).

| [-instance ] }

If this parameter is specified, the command displays information about all entries.

[-vserver <vserver name>] - Vserver

Selects information about the policies that match the specified Vserver.

[-policy <text>] - Efficiency Policy Name

Selects information about the policies that match the specified policy name.

[-type {threshold|scheduled}] - Policy Type

Selects information about the policies that match the specified policy type. There are two possible values - threshold and scheduled .

[-schedule <text>] - Job Schedule Name

Selects information about the policies that match the specified schedule.

[-duration <text>] - Duration

Selects information about the policies that match the specified duration hours.

[-start-threshold-percent <percent>] - Threshold Percentage

Selects information about the policies that match the specified start-threshold-percent. Valid only if -type parameter is set as threshold .

[-qos-policy {background|best_effort}] - QoS Policy

Selects information about the policies that match the specified throttling method. The values can be background or best-effort .

[-enabled {true|false}] - Enabled

Selects information about the policies that have the specified enabled setting.

[-comment <text>] - Comment

Selects information about the policies that match the specified comment.

[-policy-owner {cluster-admin|vserver-admin}] - Owner of the Policy

Selects information about the policies that match the specified owner. The values can be cluster-admin or vserver-admin .

Examples

The following example shows all the efficiency policies with the matching Vserver vs1.

cluster1::> volume efficiency policy show -vserver vs1
         Policy       Job        Duration
Vserver  Name         Schedule   (Hours)  QoS Policy  Enabled  Comment
-------- ------------ ---------- -------- ----------- -------- --------------
vs1      default      daily      -        best_effort true     Default policy
vs1      inline-only  -          -        -           -        Inline-Only
                                                               policy
vs1      policy1      daily      -        best_effort true     user-defined
3 entries were displayed.

The following example shows all the policies with the following fields - Vserver (default), policy (default) and duration.

cluster1::> volume efficiency policy show -fields duration
vserver policy      duration
------- -------     --------
vs1     default     -
vs1     inline-only -
vs1     policy1     -
3 entries were displayed.