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 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.

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.
[-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.
[-cross-volume-dedupe | -A [true]] - Undo Cross Volume Deduplication
Undo the effects of cross volume deduplication.
[-extended-compression | -X [true]] - Extended Compression
Undo the effects of extended compression. This removes the compression savings for data that requires more resources to compress.
[-auto-adaptive-compression | -c [true]] - Auto Adaptive Compression
Undo the effects of auto adaptive compression.
[-undo-compression-algorithm-list | -Z {lzopro|zstd}, ...] - Undo Compression Algorithm List
Undo the effects of the specified compression algorithms.

Examples

The following are examples of how to use efficiency undo.

To undo deduplication and compression savings, but not compaction 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 a Vserver named vs1:

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