lsvdiskcopy

Use the lsvdiskcopy command to list volume copy information.

Syntax

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 copy_id: (Optional) Specifies the volume copy to list information for. You must specify a vdisk_name | vdisk_id value with this parameter.
vdisk_name | vdisk_id: (Optional) Specifies the volume to list copy information for. You must specify this parameter last on the command line. If you specify a vdisk_name | vdisk_id value only, all copies for the volume are listed.

Description

The lsvdiskcopy command lists information for volume copies. If you specify the command with no parameters, all volumes and copies in the clustered system are listed.

The command returns values for the following volume copy attributes:

copy_id

Specifies a system-assigned identifier for the volume copy. The value can be 0 or 1.

status

Indicates the status. The value can be online, offline, or deleting. 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 value is the same as the volume capacity value for standard-provisioned copies.
This field is blank for volume copies that are thin-provisioned or 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 value is the same as the volume capacity value for standard-provisioned copies.
This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

free_capacity

Indicates the difference between the real_capacity and used_capacity values.

Remember:

This value is 0 for standard-provisioned copies.
This field is blank for volume copies that are thin-provisioned or compressed volume copies in a data reduction pool.

Remember: This value is zero for standard-provisioned copies.

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 blank for storage pools that are not thin-provisioned or 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 of the volume capacity for thin-provisioned or compressed volume copies, indicates that a warning is generated when the ratio of used_capacity to volume capacity reaches the specified level.

Remember: This field is blank for storage pools that are not thin-provisioned or 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 value is always blank for compressed volume copies in regular storage pools.

se_copy

Specifies whether the copy is thin-provisioned.

easy_tier

Indicates whether Easy Tier® is permitted to manage the pool.

Remember:

If easy_tier is on, then easy_tier_status can take on any value.
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.
balanced indicates that a pool is being managed by Easy Tier to provide performance-based pool balancing (for example, extents can be moved).
measured indicates that statistics are being gathered for this volume copy, but no extents are 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.

Important: For thin-provisioned copies, the capacity by tier is the real capacity.

Important: By design, tier_capacity reports blank for thin-provisioned and compressed copies in data reduction pools.

compressed_copy

Indicates whether the volume copy is compressed.

uncompressed_used_capacity

For compressed volume copies, indicates the amount of data 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 written to a thin-provisioned or compressed volume copy in a data reduction storage pool before data reduction occurs. This field is blank for standard-provisioned 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.