lssevdiskcopy

Use the lssevdiskcopy command to list the thin-provisioned copies of the specified volumes.

Syntax

Read syntax diagramSkip visual syntax diagram lssevdiskcopy -copyidvdisk_namevdisk_idvdisk_uid

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-filtervalue attribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
-filtervalue?
(Optional) Displays a list of valid filter attributes.
-bytes
(Optional) Displays all capacities as bytes. Capacity values that are displayed in units other than bytes might be rounded.
-copy id
(Optional) Specifies the volume copy to list thin-provisioned copies for. You must specify a vdisk_name | vdisk_id value with this parameter.
vdisk_name | vdisk_id | vdisk_uid
(Optional) Specifies the volume name, ID, or UID to list thin-provisioned copies for. You must specify this parameter last on the command line. If you do not enter this parameter, the command lists all thin-provisioned copies in the clustered system.

Description

The lssevdiskcopy command lists all thin-provisioned copies of the specified volume. If you do not specify a volume, the command lists all thin-provisioned volume copies in the clustered system.

The command provides a concise view of the thin-provisioned properties of the selected volume copies. Run the lsvdiskcopy command to see a concise view of the properties that are common to thin-provisioned and non-thin-provisioned volume copies. See the description of the lsvdisk command for a description of the fields that are shown in the view.

The command returns values for the following volume copy attributes:
copy_id
Indicates a system-assigned identifier for the volume copy. The value can be 0 or 1.
status
Indicates the system status. The value can be online or offline. A copy is offline if all nodes cannot access the storage pool that contains the copy.
sync
Indicates whether the volume copy is synchronized.
auto_delete
Indicates that the primary copy is deleted after the secondary copy is synchronized. The values are yes or no.
primary
Indicates whether the volume copy is the primary copy. A volume has exactly one primary copy. The value can be yes or no.
mdiskgrp_id
Indicates the ID of the storage pool that the volume copy belongs to.
mdiskgrp_name
Indicates the name of the storage pool that the volume copy belongs to.
type
Indicates the virtualization type of the volume. The value can be striped, sequential, or image.
mdisk_id
Indicates the MDisk ID that is used for sequential and image mode volumes.
mdisk_name
Indicates the MDisk name that is used for sequential and image mode volumes.
fast_write_state
Indicates the cache state of the volume copy. The value can be empty, not_empty, corrupt, or repairing. The value is always empty for non-thin-provisioned copies. A cache state of corrupt indicates that the volume is thin-provisioned and requires repair that is initiated by a recovervdisk command or the repairsevdiskcopy command.
used_capacity
Indicates the portion of real_capacity that is being used to store data. For non-thin-provisioned copies, this value is the same as the volume capacity. If the volume copy is thin-provisioned, the value increases from zero to the real_capacity value as more of the volume is written to.
Remember: This field is blank for thin-provisioned and compressed volume copies in a data reduction pool.
real_capacity
Indicates the amount of physical storage that is allocated from a storage pool to this volume copy. If the volume copy is not thin-provisioned, the value is the same as the volume capacity. If the volume copy is thin-provisioned, the value can be different.
Remember: This field is blank for thin-provisioned and compressed volume copies in a data reduction pool.
free_capacity
Indicates the difference between the real_capacity and used_capacity values.
Remember: This field is blank for thin-provisioned and compressed volume copies in a data reduction pool.
overallocation
Expressed as a percentage, indicates the ratio of volume capacity to real_capacity values. This value is always 100 for non-thin-provisioned volumes.
Remember: This field is zero for thin-provisioned and compressed volume copies in a data reduction pool.
autoexpand
Indicates whether autoexpand is enabled on a thin-provisioned volume. The value can be on or off.
warning
Expressed as a percentage, for thin-provisioned volume copies only, indicates that a warning is generated when the ratio of used_capacity to volume capacity reaches the specified level.
Remember: This field is zero for thin-provisioned and compressed volume copies in a data reduction pool.
grainsize
For thin-provisioned volume copies, indicates the grain size that is chosen for the volume copy when it was created.
Remember: This field is blank for compressed volume copies in regular storage pools.
se_copy
Indicates whether the copy is thin-provisioned. The value can be yes or no.
easy_tier
Indicates whether Easy Tier® is permitted to manage the pool.
Note:
  1. If easy_tier is on, then easy_tier_status can take on any value.
  2. If easy_tier is off, then easy_tier_status is measured or inactive.
easy_tier_status
Indicates which Easy Tier functions are active for the volume copy:
  • active indicates that a pool is being managed by Easy Tier to provide tier management performance-based pool balancing. For example, extents of this volume copy can be moved for performance (automatic data placement).
  • inactive indicates that no Easy Tier function is active.
  • measured indicates that statistics are being gathered for this volume copy, but no extents are moved.
  • balanced indicates that a pool is being managed by Easy Tier to provide performance-based pool balancing (for example, extents can be moved).
tier
Indicates which tier information is being reported:
  • tier0_flash
  • tier1_flash
  • tier_enterprise
  • tier_nearline
  • tier_scm
tier_capacity
Indicates the total MDisk capacity that is assigned to the volume in the tier.
Note: For thin-provisioned copies, the capacity by tier is the real capacity.
compressed_copy
Indicates whether the volume copy is compressed.
uncompressed_used_capacity
For compressed volume copies, indicates the amount of data that is written to the volume copy before compression. This field is blank for volume copies in a data reduction storage pool.
used_capacity_before_reduction
Indicates the total amount of data that is written to a thin-provisioned or compressed volume copy in a data reduction storage pool before data reduction occurs. This field is blank for fully allocated volume copies and volume copies not in a data reduction pool.
parent_mdisk_grp_id
Indicates the physical storage pool ID that the volume extents are allocated from. This value is a numeric string (in the range 0 - 127 characters) or blank.
parent_mdisk_grp_name
Indicates the physical storage pool name that the volume extents are allocated from. This value is an alphanumeric string (in the range 1 - 63 characters) or blank.
When using the partition IP address to run this command, consider the following:
  • The user must identify objects using the name or UUID. Short IDs cannot be specified when using the partition IP address.
  • Views will be filtered to display only objects related to the partition associated with the IP address. An error will be displayed if the user requests a detailed view for an object that is not related to the partition.