Description

The volume efficiency show command displays the information about storage efficiency of volumes. The command output depends on the parameter or parameters specified. If no parameters are specified, the command displays the following information for all volumes with efficiency:

• Vserver: Vserver the volume belongs to.
• Volume: Name of the volume.
• State: Current state of efficiency on the volume (Enabled or Disabled).
• Status: Status of the efficiency on the volume. Following are the possible values:
  • Active: An efficiency operation is currently running.
  • Idle: There are no efficiency operations running.
  • Initializing: An efficiency operation is being initialized.
  • Undoing: Efficiency is being undone on the volume.
  • Pending: An efficiency operation is queued.
  • Downgrading: An efficiency operation necessary to downgrade the efficiency metafiles to a previous Data ONTAP release is active.
  • Disabled: Efficiency is disabled on the volume.
  Status is not supported for Infinite Volumes and will display a value of "-"
• Progress: The progress of the current efficiency operation with information as to which stage of the efficiency process is currently in progress and how much data is processed for that stage. For example: "25 MB Scanned", "20 MB Searched", "500 KB (2%) Compressed", "40 MB (20%) Done", "30 MB Verified". Progress is not supported for Infinite Volumes and will display a value of "-"

To display detailed information, run the command with the -l or -instance parameter. The detailed view provides all information in the previous list and the following additional information (fields not supported by Infinite Volumes will display a value of "-"):

• Path: Volume Path.
• Compression: Current state of compression on the volume (Enabled or Disabled).
• Inline Compression: Current state of inline compression on the volume (Enabled or Disabled).
• Incompressible Data Detection: Current state of Incompressible Data Detection on the volume (Enabled or Disabled).
• Compression Quick Check File Size: Minimum file size (in bytes) to attempt Quick Check on a file. The default value is 500MB.
• Type: Type of volume (Regular or SnapVault).
• Schedule: The schedule of efficiency operation for the volume.
• Policy: Efficiency policy for the volume.
• Minimum Blocks Shared: The minimum number of adjacent blocks in a file that can be shared.
• Blocks Skipped Sharing: Blocks skipped sharing because of the minimum block share value. This parameter is not supported on Infinite Volumes.
• Last Operation State: Status of the last operation (Success or Failure). Not supported on Infinite Volumes.
• Last Successful Operation Begin: The time and date at which the last successful operation began. This parameter is not supported on Infinite Volumes.
• Last Successful Operation End: The time and date at which the last successful operation ended. This parameter is not supported on Infinite Volumes.
• Last Operation Begin: The time and date at which the last operation began. This parameter is not supported on Infinite Volumes.
• Last Operation End: The time and date at which the last operation ended. This parameter is not supported on Infinite Volumes.
• Last Operation Size: The size of the last operation. This parameter is not supported on Infinite Volumes.
• Last Operation Error: The error encountered by the last operation. This parameter is not supported on Infinite Volumes.
• Change Log Usage: The percentage of the change log that is used. This parameter is not supported on Infinite Volumes.
• Logical Data: The total logical data in the volume, and how much is reached compared to the deduplication logical data limit. This parameter is not supported on Infinite Volumes.
• Queued Job: The job that is queued. Following are the possible values:
  • -: There are no queued jobs.
  • scan: A job to process existing data is queued.
  • start: A job to process newly added data is queued.
  • check: A job to eliminate stale data from the fingerprint database is queued.
  • downgrading: An efficiency operation necessary to downgrade the efficiency metafiles to a previous Data ONTAP release is queued.
• Stale Fingerprints: The percentage of stale entries in the fingerprint database. If this is greater than 20 percent a subsequent volume efficiency start operation triggers the verify operation, which might take a long time to complete. This parameter is not supported on Infinite Volumes.

You can specify additional parameters to display information that matches only those parameters. For example, to display information only about volumes with efficiency in Vserver vs1, run the command with the -vserver vs1 parameter.

Parameters

{  [-fields <fieldname>, ...]

|  [-l ]

|  [-instance ]  }

[-vserver <vserver name>] - Vserver Name

{  [-volume <volume name>] - Volume Name

|  [-path </vol/volume>]  } - Volume Path

[-state {Disabled|Enabled}] - State

[-op-status <Efficiency status>] - Status

[-progress <text>] - Progress

[-type {Regular|SnapVault}] - Type

[-schedule <text>] - Schedule

[-policy <text>] - Efficiency Policy Name

[-compression-type {secondary|adaptive}] - Compression type (privilege: advanced)

[-blks-skipped-sharing <integer>] - Blocks Skipped Sharing

[-last-op-state <text>] - Last Operation State

[-last-success-op-begin <Date>] - Last Success Operation Begin

[-last-success-op-end <Date>] - Last Success Operation End

[-last-op-begin <Date>] - Last Operation Begin

[-last-op-end <Date>] - Last Operation End

[-last-op-size {<integer>[KB|MB|GB|TB|PB]}] - Last Operation Size

[-last-op-error <text>] - Last Operation Error

[-changelog-usage <percent_no_limit>] - Changelog Usage

[-logical-data-size {<integer>[KB|MB|GB|TB|PB]}] - Logical Data Size

[-logical-data-limit {<integer>[KB|MB|GB|TB|PB]}] - Logical Data Limit

[-logical-data-percent <percent_no_limit>] - Logical Data Percent

[-queued-job <text>] - Queued Job

[-stale-fingerprint-percentage <integer>] - Stale Fingerprint Percentage

[-compression {true|false}] - Compression

[-inline-compression {true|false}] - Inline Compression

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

[-is-constituent {true|false}] - Constituent Volume

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

Examples

The following example displays information about all volumes with efficiency on the Vserver named vs1:

cluster1::> volume efficiency show -vserver vs1
Vserver     Volume              State    Status       Progress
----------- ------------------- -------- ------------ -------------------
vs1         vol1                Enabled  Idle         Idle for 22:37:53
vs1         vol2                Enabled  Idle         Idle for 22:37:53
vs1         vol3                Enabled  Idle         Idle for 22:37:49
vs1         vol4                Enabled  Idle         Idle for 22:37:53
vs1         vol5                Enabled  Idle         Idle for 22:37:53
vs1         volham              Enabled  Idle         Idle for 22:37:53
vs1         volham1             Enabled  Idle         Idle for 22:37:53
7 entries were displayed.

The following example displays detailed information about a volume named vol1 on a Vserver named vs1:

 cluster1::> volume efficiency show -vserver vs1 -volume vol1
                     Vserver Name: vs1
                      Volume Name: vol1
                      Volume Path: /vol/vol1
                            State: Enabled
                           Status: Idle
                         Progress: Idle for 00:00:14
                             Type: Regular
                         Schedule: sun-sat@0
           Efficiency Policy Name: -
                Min Blocks Shared: 1
           Blocks Skipped Sharing: 0
             Last Operation State: success
     Last Success Operation Begin: Mon Nov 15 20:13:26 UTC 2010
       Last Success Operation End: Mon Nov 15 20:13:26 UTC 2010
             Last Operation Begin: Mon Nov 15 20:13:26 UTC 2010
               Last Operation End: Mon Nov 15 20:13:26 UTC 2010
              Last Operation Size: 0.00B
             Last Operation Error: -
                 Change Log Usage: 0%
                Logical Data Size: 156KB
               Logical Data Limit: 50.00TB
             Logical Data Percent: 0%
                       Queued Job: -                                              
     Stale Fingerprint Percentage: 0
                      Compression: false
               Inline Compression: false
    Incompressible Data Detection: false
Compression Quick Check File Size: 524288000

See Also