volume show-space

Display space usage for volume(s)

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

Description

The volume show-space command displays information about space usage within the volume. 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.

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.
[-user-data {<integer>[KB|MB|GB|TB|PB]}] - User Data
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by user data in the volume.

This is the amount of data written to the volume via CIFS, NFS or SAN protocols plus the metadata (for example indirect blocks, directory blocks) directly associated with user files plus the space reserved in the volume for these files (hole and overwrite reserves). This is the same information displayed by running the Unix du command on the mount point.

[-user-data-percent <percent_no_limit>] - User Data Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by user data in the volume.
[-dedupe-metafiles {<integer>[KB|MB|GB|TB|PB]}] - Deduplication
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by deduplication metafiles in the volume.
[-dedupe-metafiles-percent <percent>] - Deduplication Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by deduplication metafiles in the volume.
[-dedupe-metafiles-temporary {<integer>[KB|MB|GB|TB|PB]}] - Temporary Deduplication
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by temporary deduplication metafiles in the volume.
[-dedupe-metafiles-temporary-percent <percent>] - Temporary Deduplication Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by temporary deduplication metafiles in the volume.
[-filesystem-metadata {<integer>[KB|MB|GB|TB|PB]}] - Filesystem Metadata
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by file system metadata in the volume.
[-filesystem-metadata-percent <percent>] - Filesystem Metadata Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by file system metadata in the volume.
[-snapmirror-metadata {<integer>[KB|MB|GB|TB|PB]}] - SnapMirror Metadata
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by SnapMirror metafiles in the volume.

Between SnapMirror transfers, some metadata is maintained to support storage-efficient transfers. During transfers, some additional space is used temporarily. This space is used in all SnapMirror destination volumes.

[-snapmirror-metadata-percent <percent>] - SnapMirror Metadata Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by SnapMirror metafiles inside the volume.
[-tape-backup-metadata {<integer>[KB|MB|GB|TB|PB]}] - Tape Backup Metadata
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by tape backup metafiles in the volume.
[-tape-backup-metadata-percent <percent>] - Tape Backup Metadata Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by tape backup metafiles in the volume.
[-quota-metafiles {<integer>[KB|MB|GB|TB|PB]}] - Quota Metadata
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by quota metafiles.
[-quota-metafiles-percent <percent>] - Quota Metadata Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by quota metafiles.
[-inodes {<integer>[KB|MB|GB|TB|PB]}] - Inodes
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by the inode metafile in the volume.

This is the amount of space required to store inodes in the file system and is proportional to the maximum number of files ever created in the volume. The inode file is not compacted or truncated, so if a large number of files are created and then deleted, the inode file does not shrink.

[-inodes-percent <percent>] - Inodes Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by the inode metafile in the volume.
[-inodes-upgrade {<integer>[KB|MB|GB|TB|PB]}] - Inodes Upgrade
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by the inode subsystem for the purpose of upgrading.

This is the amount of space required to store upgrading inodes in the file system and is proportional to the size of the inode metafile. Once the upgrade is complete, the space used by 'inodes' will be replaced with the space used for upgrade.

[-inodes-upgrade-percent <percent>] - Inodes Upgrade Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use for upgrading the inode metafile in the volume.
[-snapshot-reserve {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Reserve
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by the Snapshot reserve in the volume.
[-snapshot-reserve-percent <percent>] - Snapshot Reserve Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by the Snapshot reserve in the volume.
[-snapshot-reserve-unusable {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Reserve Unusable
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space reserved but unusable in the volume.

Snapshot reserve can be diminished under certain conditions to accomodate volume metadata. Creating space in the volume will make this space available.

[-snapshot-reserve-unusable-percent <integer>] - Snapshot Reserve Unusable Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space reserved but unusable.
[-snapshot-spill {<integer>[KB|MB|GB|TB|PB]}] - Snapshot Spill
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by their Snapshot spill.

If Snapshot used space exceeds the Snapshot reserve it is considered to spill out of the reserve. This space cannot be used by the active file system until Snapshots are deleted.

[-snapshot-spill-percent <percent>] - Snapshot Spill Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by the Snapshot spill.
[-performance-metadata {<integer>[KB|MB|GB|TB|PB]}] - Performance Metadata
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use for performance optimization in the volume.
[-performance-metadata-percent <percent>] - Performance Metadata Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use for performance optimization in the volume.
[-total-used {<integer>[KB|MB|GB|TB|PB]}] - Total Used
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of space in use by the volume, including the space used by the Snapshot reserve.

This is equivalent to the used field in the output of the volume show command.

[-total-used-percent <percent_no_limit>] - Total Used Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of space in use by the volume, including the space used by the Snapshot reserve.
[-physical-used {<integer>[KB|MB|GB|TB|PB]}] - Total Physical Used Size
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of physical space in use by the volume.

This differs from total-used space by the space that is reserved for future writes. The value includes blocks in use by Snapshot copies.

[-physical-used-percent <percent_no_limit>] - Physical Used Percentage
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of physical space in use in the volume based on volume size including the space reserved for Snapshot copies.
[-logical-used {<integer>[KB|MB|GB|TB|PB]}] - Logical Used Size
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of logical space in use by the volume. This includes space saved by all the storage efficiency features along with physical used space. This does not include Snapshot reserve but does consider Snapshot spill.
[-logical-used-percent <percent_no_limit>] - Logical Used Percent
If this parameter is specified, the command displays information only about the volume or volumes that have the specified percentage of logical space used in the volume.
[-logical-available {<integer>[KB|MB|GB|TB|PB]}] - Logical Available
If this parameter is specified, the command displays information only about the volume or volumes that have the specified amount of logical available space in the volume.

Examples

The following example shows how to display details for all volumes.


cluster1::> volume show-space

      Vserver : nodevs
      Volume  : vol0

      Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                               163.4MB         3%
      Filesystem Metadata                       172KB         0%
      Inodes                                   2.93MB         0%
      Snapshot Reserve                        292.9MB         5%

      Total Used                              459.4MB         8%

      Total Physical Used                     166.4MB         3%


      Vserver : thevs
      Volume  : rootvol

      Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                                 100KB         0%
      Filesystem Metadata                        76KB         0%
      Inodes                                     24KB         0%
      Snapshot Reserve                            1MB         5%

      Total Used                               1.20MB         6%

      Total Physical Used                       200KB         1%


      Vserver : vs1
      Volume  : vol1

      Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                               180.8MB        74%
      Filesystem Metadata                       280KB         0%
      Inodes                                     12KB         0%
      Snapshot Reserve                        12.20MB         5%

      Total Used                              193.3MB        79%

      Total Physical Used                     192.9MB        79%


3 entries were displayed.

		

The following example shows all Volumes that have a snap reserve greater than 2 MB:

cluster1::> volume show-space -snapshot-reserve >2m

      Vserver : nodevs
      Volume  : vol0

      Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                               163.4MB         3%
      Filesystem Metadata                       172KB         0%
      Inodes                                   2.93MB         0%
      Snapshot Reserve                        292.9MB         5%

      Total Used                              459.4MB         8%

      Total Physical Used                     166.4MB         3%


      Vserver : vs1
      Volume  : vol1

      Feature                                    Used      Used%
      --------------------------------     ----------     ------
      User Data                               180.8MB        74%
      Filesystem Metadata                       280KB         0%
      Inodes                                     12KB         0%
      Snapshot Reserve                        12.20MB         5%

      Total Used                              193.3MB        79%

      Total Physical Used                     192.9MB        79%


2 entries were displayed.