Use the lsvdiskcopy command to list volume copy
information.
Syntax
lsvdiskcopy [ -nohdr ] [ -bytes ] [ -delim delimiter ] [ -filtervalue? ] [ { { vdisk_name | vdisk_id } | -copy copy_id { vdisk_name | vdisk_id } } ]
Parameters
- -nohdr
- (Optional) By default, headings are displayed for each column of data in a concise
style view, and for each item of data in a detailed style view. The
-nohdr parameter suppresses the display of these
headings.
Note: If no data exists to be displayed, headings are not
displayed.
- -bytes
- (Optional) Displays all capacities as bytes. Capacity values that are displayed in
units other than bytes might be rounded.
- -delimdelimiter
- (Optional) By default in a concise view, all columns of data are space-separated. The
width of each column is set to the maximum width of each item of data. In a detailed
view, each item of data has its own row, and if the headers are displayed, the data is
separated from the header by a space. The -delim parameter
overrides this behavior. Valid input for the -delim parameter is a
1-byte character. If you enter -delim : on the command line, the
colon character (:) separates all items of data in a concise view;
for example, the spacing of columns does not occur. In a detailed view, the data is
separated from its header by the specified delimiter.
- -copycopy_id
- (Optional) Specifies the volume copy to list information for. You must specify a
vdisk_name | vdisk_id value with this
parameter.
- -filtervalue?
- (Optional) Displays a list of valid filter attributes. The following filters for the
lsvdiskcopy command are valid:
- primary
- status
- sync
- mdisk_grp_id
- mdisk_grp_name
- type
- easy_tier
- easy_tier_status
- deduplicated_copy
- 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 fully allocated
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 fully allocated
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 fully allocated 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 fully allocated 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.
Note: - 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.
If the volume copy is in image or sequential mode or is being
migrated, then the volume copy Easy Tier
status is measured instead of
active.
The default Easy Tier setting for a storage
pool is auto, and the default Easy Tier setting for a volume copy is
on. If the setting is
on, it means that Easy Tier functions except pool performance balancing
are disabled for storage pools with a single tier, and that automatic data placement
mode is enabled for all striped volume copies in a storage pool with two or more
tiers.
- tier
- Indicates which tier information is being reported:
- tier0_flash
- tier1_flash
- tier_enterprise
- tier_nearline
- 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.
Note: 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 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.
- encrypt
- Indicates whether the volume and its copies are encrypted. The values are
yes or no.
- deduplicated_copy_count
- Indicates the number of data deduplicated volume copies.
- deduplicated_copy
- Indicates whether the volume copy is data deduplicated. The values are:
An invocation example
lsvdiskcopy -delim :
The
following output is displayed:
vdisk_id:vdisk_name:copy_id:status:sync:primary:mdisk_grp_id:mdisk_grp_name:capacity:type:se_copy:easy_tier:easy_tier_status:compressed_copy
0:RAM_V2:0:online:yes:yes:2:RAM_MDG2:5.00GB:striped:yes:on:inactive:yes
1:RAM_V3:0:online:yes:yes:2:RAM_MDG2:5.00GB:striped:no:on:inactive:no
2:RAM_V4:0:online:yes:yes:1:RAM_MDG3:5.00GB:striped:no:on:inactive:yes
3:RAM_V5:0:online:yes:yes:2:RAM_MDG2:5.00GB:striped:yes:on:inactive:no
3:RAM_V5:1:online:yes:no:2:RAM_MDG2:5.00GB:striped:yes:on:inactive:yes
4:RAM_V1:0:online:yes:yes:3:RAM_MDG1:5.00GB:striped:no:on:inactive:no
5:RAM_V6:0:online:yes:yes:0:RAM_MDG4:5.00GB:striped:yes:on:inactive:yes
An invocation
example
lsvdiskcopy -copy 0 –delim : vv1
The
following output is displayed:
vdisk_id:0
vdisk_name:vv1
capacity:16.00GB
copy_id:0
status:online
sync:yes
auto_delete:yes
primary:yes
mdisk_grp:1
mdisk_grp name:mdisk_group_1
type:striped
mdisk_id:
mdisk_name:
fast_write_state:not_empty
used_capacity:2.00GB
real_capacity:8.00GB
free_capacity:6.00GB
overallocation:200
autoexpand:on
warning:25
grainsize:256
se_copy:yes
easy_tier:on
easy_tier_status:active
tier:tier0_flash
tier_capacity:1.63TB
tier:tier1_flash
tier_capacity:1.63TB
tier:tier_enterprise
tier_capacity:
tier:tier_nearline
tier_capacity:0.00MB
tier_capacity:64.00MB
tier:tier0_flash
tier_capacity:1.63TB
tier:tier1_flash
tier_capacity:1.63TB
tier:tier_enterprise
tier_capacity:
tier:tier_nearline
tier_capacity:0.00MB
tier_capacity:7.94GB
compressed_copy:yes
uncompressed_used_capacity:1.0MB
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5
encrypt:yesused_capacity_before_reduction
An invocation
example
lsvdiskcopy -copy 0 –delim : vv1
The
following output is
displayed:
vdisk_id:0
vdisk_name:vv1
capacity:16.00GB
copy_id:0
status:online
sync:yes
auto_delete:yes
primary:yes
mdisk_grp_id:1
mdisk_grp_name:mdisk_group_1
type:striped
mdisk_id:
mdisk_name:
fast_write_state:empty
used_capacity:2.00GB
real_capacity:8.00GB
free_capacity:6.00GB
overallocation:200
autoexpand:on
warning:25
grainsize:256
se_copy:yes
easy_tier:off
easy_tier_status:inactive
tier:tier0_flash
tier_capacity:1.63TB
tier:tier1_flash
tier_capacity:1.63TB
tier:tier_enterprise
tier_capacity:
tier:tier_nearline
tier_capacity:0.00MB
compressed_copy:no
uncompressed_used_capcaity:8.00GB
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5encrypt:yesused_capacity_before_reduction
An invocation example
lsvdisk 0
The following output is displayed:
vdisk_id:0
vdisk_name:vv1
...
deduplicated_copy_count:1
..
...
copy_id 0
...
deduplicated_copy:yes
used_capacity_before_reduction:12.54GB