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 there is no data 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
- 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 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 once 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.
- 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.
- free_capacity
- Indicates the difference between the real_capacity and
used_capacity values.
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.
- 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.
- grainsize
- For thin-provisioned volume copies, indicates the grain size that is chosen for the
volume copy when it was created.
- se_copy
- Specifies if 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.
- 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_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 or not the volume copy is compressed.
- uncompressed_used_capacity
- For compressed volumes, indicates the amount of data that is written to the volume before
compression.
- 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.
An invocation example
lsvdiskcopy -delim :
The resulting output:
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 resulting output:
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:0.00MB
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:0.00MB
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:yes
An invocation example
lsvdiskcopy -copy 0 –delim : vv1
The resulting ouput:
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:0.00MB
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:yes