volume show-footprint

Display a list of volumes and their data and metadata footprints in their associated aggregate.

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

Description

The volume show-footprint command displays information about the space used in associated aggregates by volumes and features enabled in volumes. The command output depends on the parameter or parameters specified with the command. If no parameters are specified, the command displays the following information about all volumes. If the associated aggregates have an object-store attached to them, then the command displays a more detailed split up of the space used in each tier. This additional information is useful to show per-tier space usage which can be used to estimate the space requirements and transfer duration when moving a volume to a different tier with volume move.

Parameters

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-vserver <vserver name>] - Vserver
If this parameter and the -volume parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about volumes on the specified Vserver.
[-volume <volume name>] - Volume Name
If this parameter and the -vserver parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about all volumes matching the specified name.
[-volume-msid <integer>] - Volume MSID
If this parameter is specified, the command displays information only about the volume that has the specified MSID.
[-volume-dsid <integer>] - Volume DSID
If this parameter is specified, the command displays information only about the volume that has the specified DSID.
[-vserver-uuid <UUID>] - Vserver UUID
If this parameter is specified, the command displays information only about the volume on the vserver which has the specified UUID.
[-aggregate <aggregate name>] - Aggregate Name
If this parameter is specified, the command displays information only about the volumes that are associated with the specified aggregate.
[-aggregate-uuid <UUID>] - Aggregate UUID
If this parameter is specified, the command displays information only about the volumes on the aggregate which have the specified UUID.
[-hostname <text>] - Hostname
If this parameter is specified, the command displays information only about the volumes that belong to the specified host.
[-tape-backup-metafiles-footprint {<integer>[KB|MB|GB|TB|PB]}] - Tape Backup Metadata Footprint
If this parameter is specified, the command displays information only about the volumes whose tape backup metafiles use the specified amount of space in the aggregate.
[-tape-backup-metafiles-footprint-percent <percent>] - Tape Backup Metadata Footprint Percent
If this parameter is specified, the command displays information only about the volumes whose tape backup metafiles use the specified percentage of space in the aggregate.
[-dedupe-metafiles-footprint {<integer>[KB|MB|GB|TB|PB]}] - Deduplication Footprint
If this parameter is specified, the command displays information only about the volumes whose deduplication metafiles use the specified amount of space in the aggregate.
[-dedupe-metafiles-footprint-percent <percent>] - Deduplication Footprint Percent
If this parameter is specified, the command displays information only about the volumes whose deduplication metafiles use the specified percentage of space in the aggregate.
[-dedupe-metafiles-temporary-footprint {<integer>[KB|MB|GB|TB|PB]}] - Temporary Deduplication Footprint
If this parameter is specified, the command displays information only about the volumes whose temporary deduplication metafiles use the specified amount of space in the aggregate.
[-dedupe-metafiles-temporary-footprint-percent <percent>] - Temporary Deduplication Footprint Percent
If this parameter is specified, the command displays information only about the volumes whose temporary deduplication metafiles use the specified percentage of space in the aggregate.
[-cross-volume-dedupe-metafiles-footprint {<integer>[KB|MB|GB|TB|PB]}] - Cross Volume Deduplication Footprint
If this parameter is specified, the command displays information only about the volumes whose cross volume deduplication metafiles use the specified amount of space in the aggregate.
[-cross-volume-dedupe-metafiles-footprint-percent <percent>] - Cross Volume Deduplication Footprint Percent
If this parameter is specified, the command displays information only about the volumes whose cross volume deduplication metafiles use the specified percentage of space in the aggregate.
[-cross-volume-dedupe-metafiles-temporary-footprint {<integer>[KB|MB|GB|TB|PB]}] - Cross Volume Temporary Deduplication Footprint
If this parameter is specified, the command displays information only about the volumes whose cross volume deduplication temporary metafiles use the specified amount of space in the aggregate.
[-cross-volume-dedupe-metafiles-temporary-footprint-percent <percent>] - Cross Volume Temporary Deduplication Footprint Percent
If this parameter is specified, the command displays information only about the volumes whose cross volume deduplication temporary metafiles use the specified percentage of space in the aggregate.
[-volume-blocks-footprint {<integer>[KB|MB|GB|TB|PB]}] - Volume Data Footprint
If this parameter is specified, the command displays information only about the volumes whose data blocks use the specified amount of space in the aggregate.

This field is the total amount of data written to the volume. It includes data in the active file system in the volume as well as data that is consumed by volume Snapshot copies. This row only includes data and not reserved space, so when volumes have reserved files, the volume's total used in the volume show-space command output can exceed the value in this row.

[-volume-blocks-footprint-percent <percent>] - Volume Data Footprint Percent
If this parameter is specified, the command displays information only about the volumes whose data blocks use the specified percentage of space in the aggregate.
[-flexvol-metadata-footprint {<integer>[KB|MB|GB|TB|PB]}] - Flexible Volume Metadata Footprint
If this parameter is specified, the command displays information only about the volumes whose file system metadata uses the specified amount of space in the aggregate.

This field includes the space used or reserved in the aggregate for metadata associated with this volume.

[-flexvol-metadata-footprint-percent <percent>] - Flexible Volume Metadata Footprint Percent
If this parameter is specified, the command displays information only about the volumes whose file system metadata uses the specified percentage of space in the aggregate.
[-delayed-free-footprint {<integer>[KB|MB|GB|TB|PB]}] - Delayed Free Blocks
If this parameter is specified, the command displays information only about the volumes whose delayed free blocks use the specified amount of space in the aggregate.

When Data ONTAP frees space in a volume, this space is not always immediately shown as free in the aggregate. This is because the operations to free the space in the aggregate are batched for increased performance. Blocks that are declared free in the FlexVol volume but which are not yet free in the aggregate are called "delayed free blocks" until the associated delayed free blocks are processed. For SnapMirror destinations, this row will have a value of 0 and will not be displayed.

[-delayed-free-footprint-percent <percent>] - Delayed Free Blocks Percent
If this parameter is specified, the command displays information only about the volumes that have the specified amount of blocks waiting to be freed in the aggregate. This space is called "delayed free blocks".
[-snapmirror-destination-footprint {<integer>[KB|MB|GB|TB|PB]}] - SnapMirror Destination Footprint
If this parameter is specified, the command displays information only about the volumes whose SnapMirror transfer uses the specified amount of space in the aggregate.

During a SnapMirror transfer, this row will include incoming SnapMirror data and SnapMirror-triggered delayed free blocks from previous SnapMirror transfers.

[-snapmirror-destination-footprint-percent <percent>] - SnapMirror Destination Footprint Percent
If this parameter is specified, the command displays information only about the volumes whose SnapMirror transfer uses the specified percentage of space in the aggregate.
[-volume-guarantee-footprint {<integer>[KB|MB|GB|TB|PB]}] - Volume Guarantee
If this parameter is specified, the command displays information only about the volumes whose guarantees use the specified amount of space in the aggregate.

This field includes the amount of space reserved by this volume in the aggregate for future writes. The amount of space reserved depends on the guarantee type (the provisioning mode) of the volume. For a "volume" guaranteed volume, this is the size of the volume minus the amount in the Volume Data Footprint row. For a "file" guaranteed volume, this is the sum of all of the space reserved for hole fills and overwrites in all of the space reserved files in the volume.

[-volume-guarantee-footprint-percent <percent>] - Volume Guarantee Percent
If this parameter is specified, the command displays information only about the volumes whose guarantees use the specified percentage of space in the aggregate.
[-file-operation-metadata {<integer>[KB|MB|GB|TB|PB]}] - File Operation Metadata
If this parameter is specified, the command displays information only about the volumes that have file operation metadata using the specified amount of space in the aggregate.

This metadata is used by file move and copy operations. Although it is not returned as free space once the operations are complete, it can be reused by future file operations.

[-file-operation-metadata-percent <percent>] - File Operation Metadata Percent
If this parameter is specified, the command displays information only about the volumes that have file operation metadata using the specified percentage of space in the aggregate.
[-total-footprint {<integer>[KB|MB|GB|TB|PB]}] - Total Footprint
If this parameter is specified, the command displays information only about the volumes which use the specified amount of space in the aggregate. This field is the sum of the other rows in this table.
[-total-footprint-percent <percent>] - Total Footprint Percent
If this parameter is specified, the command displays information only about the volumes which use the specified percentage of space in the aggregate.
[-aggregate-size {<integer>[KB|MB|GB|TB|PB]}] - Containing Aggregate Size
If this parameter is specified, the command displays information only about the volumes that are associated with an aggregate of the specified size.
[-bin0-name <text>] - Name for bin0
If this parameter is specified, the command displays information only about volumes whose associated aggregate has an object store attached to it with an active file system tier name matches the specified value.
[-volume-blocks-footprint-bin0 {<integer>[KB|MB|GB|TB|PB]}] - Volume Footprint for bin0
If this parameter is specified, the command displays information only about volumes whose space in use in the performance tier of the aggregate matches the specified value.
[-volume-blocks-footprint-bin0-percent <percent>] - Volume Footprint bin0 Percent
If this parameter is specified, the command displays information only about volumes whose percentage space in use in the performance tier of the aggregate matches the specified value.
[-bin1-name <text>] - Name for bin1
If this parameter is specified, the command displays information only about volumes whose associated aggregate has a cloud tier attached to it with a configuration name that matches the specified value.
[-volume-blocks-footprint-bin1 {<integer>[KB|MB|GB|TB|PB]}] - Volume Footprint for bin1
If this parameter is specified, the command displays information only about volumes whose space in use in the first cloud tier bucket attached to the associated aggregate matches the specified value. This includes the space used by the blocks in the volume that are staged before being moved to the cloud tier.
[-volume-blocks-footprint-bin1-percent <percent>] - Volume Footprint bin1 Percent
If this parameter is specified, the command displays information only about volumes whose percentage space in use in the first cloud tier bucket attached to associated aggregate matches the specified value. This includes the space used by the blocks in the volume that are staged before being moved to the cloud tier.

Examples

The following example displays information about all volumes in the system.


cluster1::> volume show-footprint

      Vserver : nodevs
      Volume  : vol0

      Feature                                        Used    Used%
      --------------------------------         ----------    -----
      Volume Data Footprint                       103.1MB      11%
      Volume Guarantee                            743.6MB      83%
      Flexible Volume Metadata                     4.84MB       1%
      Delayed Frees                                4.82MB       1%

      Total Footprint                             856.3MB      95%


      Vserver : thevs
      Volume  : therootvol

      Feature                                        Used    Used%
      --------------------------------         ----------    -----
      Volume Data Footprint                         116KB       0%
      Volume Guarantee                            19.83MB       1%
      Flexible Volume Metadata                      208KB       0%
      Delayed Frees                                  60KB       0%

      Total Footprint                             20.20MB       1%


      Vserver : thevs
      Volume  : thevol

      Feature                                        Used    Used%
      --------------------------------         ----------    -----
      Volume Data Footprint                         128KB       0%
      Volume Guarantee                             2.00GB      76%
      Flexible Volume Metadata                    11.38MB       0%
      Delayed Frees                                 428KB       0%

      Total Footprint                              2.01GB      76%

3 entries were displayed.

		

The following example displays information about all volumes in a system and highlights a scenario where the aggregates associated with volumes have a cloud tier attached to them.

cluster-1::> vol show-footprint

      Vserver : vsim1
      Volume  : vol0

      Feature                                   Used    Used%
      --------------------------------    ----------    -----
      Volume Data Footprint                   2.57GB      81%
      Volume Guarantee                       266.1MB       8%
      Flexible Volume Metadata               16.23MB       0%
      Delayed Frees                          27.97MB       1%

      Total Footprint                         2.87GB      90%


      Vserver : vs1
      Volume  : svm_root

      Feature                                   Used    Used%
      --------------------------------    ----------    -----
      Volume Data Footprint                   2.93MB       0%
             Footprint in Performance Tier    2.99MB     100%
             Footprint in my-store                0B       0%
      Volume Guarantee                       17.01MB       0%
      Flexible Volume Metadata                 208KB       0%
      Delayed Frees                             68KB       0%

      Total Footprint                        20.20MB       0%


      Vserver : vs1
      Volume  : vol1

      Feature                                   Used    Used%
      --------------------------------    ----------    -----
      Volume Data Footprint                   1.61GB      17%
             Footprint in Performance Tier    1.23GB      72%
             Footprint in my-store           479.0MB      28%
      Volume Guarantee                            0B       0%
      Flexible Volume Metadata               16.06MB       0%
      Delayed Frees                          82.98MB       1%

      Total Footprint                         1.71GB      18%
      Vserver : vs1
      Volume  : vol2

      Feature                                   Used    Used%
      --------------------------------    ----------    -----
      Volume Data Footprint                   1.22GB      13%
             Footprint in Performance Tier   823.3MB      65%
             Footprint in ms1                  440MB      35%
      Volume Guarantee                            0B       0%
      Flexible Volume Metadata               16.06MB       0%
      Delayed Frees                             12MB       0%

      Total Footprint                         1.25GB      13%

4 entries were displayed.