volume efficiency undo

Undo efficiency on a volume

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

Description

The command volume efficiency undo removes volume efficiency on a volume by undoing compression, undoing compaction and removing all the block sharing relationships, and cleaning up any volume efficiency specific data structures. Any efficiency operations on the volume must be disabled before issuing this command. The volume efficiency configuration is deleted when the undo process completes. The command is used to revert a volume to an earlier version of Data ONTAP where some of the efficiency features are not supported. During this revert not all efficiencies needs to be undone but only those gained by that particular feature (for example, compaction), which is not supported in the earlier version.

This command is not supported on FlexGroups that are managed by storage services.

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 name.
| -path </vol/volume>} - Volume Path
This specifies the volume path.
[-compression | -C [true]] - Decompress Data in the Volume
Undo the effects of compression. This requires efficiency to be disabled (by performing volume efficiency off).
[-dedupe | -D [true]] - Undo Block Sharing in the Volume
Undo the effects of deduplication. This requires efficiency to be disabled (by performing volume efficiency off).
[-inode | -i <integer>] - Inode Number to Undo Sharing
Remove the block sharings from a specified inode. This parameter is not supported on Infinite Volumes.
[-undo-type | -t {all|wrong}] - Selective Undo
This specifies to remove either all or only invalid block sharing. When all is used, all block sharings are removed. When wrong is used, only invalid sharings present in the volume are removed. When used along with log option, it logs information about all or wrong block sharings without sharing removal.
[-log | -d [true]] - Only Log Incorrect Savings
If specified, information about invalid block sharing relationships will only be logged. Invalid sharings will not be removed. This parameter is only valid when the parameter -undo-type is specified as wrong.
[-data-compaction | -P [true]] - Undo Data Compaction in the Volume
Undo the effects of data compaction.

Examples

The following are examples of how to use efficiency undo.

To undo deduplication savings, but not compaction or compression savings in a volume name vol1 on a Vserver named vs1:

cluster1::> volume efficiency undo -vserver vs1 -volume vol1

To rewrite compressed blocks and undo compression savings in a volume name vol1 on a Vserver named vs1:

cluster1::> volume efficiency undo -vserver vs1 -volume vol1 -compression

To rewrite compressed and deduped blocks without any efficiency in a volume name vol1 on a Vserver named vs1:

cluster1::> volume efficiency undo -vserver vs1 -volume vol1 -dedup -compression

To rewrite compacted blocks in a volume name vol1 on an SVM named vs1:

cluster1::> volume efficiency undo -vserver vs1 -volume vol1 -data-compaction