Use the lsvdiskcopy command to list
volume copy information.
Syntax
lsvdiskcopy
[ -nohdr
] [ -bytes ]
[ -delimdelimiter
] [ -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 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 possible 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 one-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 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 an 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 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 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
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
a pool is being managed by Easy Tier to provide performance-based
pool balancing (for example, extents can be moved).
| Storage pool Easy Tier setting |
Number of tiers in the storage pool |
Volume copy Easy Tier setting |
Volume copy Easy Tier status |
| Off |
One |
Off |
inactive (see note 2) |
| Off |
One |
On |
inactive (see note 2) |
| Off |
Two |
Off |
inactive |
| Off |
Two |
On |
inactive (see note 2) |
| Measure |
One |
Off |
measured (see note 3) |
| Measure |
One |
On |
measured (see note 3) |
| Measure |
Two |
Off |
measured (see note 3) |
| Measure |
Two |
On |
measured (see note 3) |
| Auto |
One |
Off |
measured (see note 3) |
| Auto |
One |
On |
balanced (see note 4) |
| Auto |
Two |
Off |
measured (see note 3) |
| Auto |
Two |
On |
active (see note 5) |
| On |
One |
Off |
measured (see note 3) |
| On |
One |
On |
balanced (see note 4) |
| On |
Two |
Off |
measured (see note 3) |
| On |
Two |
On |
active (see note 5) |
Note:
- 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.
- When the volume copy status is inactive, no Easy Tier functions are enabled for that volume copy.
- When the volume copy status is measured, the Easy Tier function collects usage statistics for the
volume but automatic data placement is not active.
- When the volume copy
status is balanced, the Easy Tier function enables performance-based pool balancing for that volume
copy.
- When the volume copy status is active, the Easy Tier function operates in automatic data placement
mode for that volume.
- The default Easy Tier setting
for a storage pool is auto, and the default Easy Tier setting for a volume copy is on. This means that Easy Tier functions except pool performance
balancing are disabled for storage pools with a single tier, and that
automatic data placement mode are enabled for all striped volume copies
in a storage pool with two or more tiers.
|
- tier
- Indicates which tier information is being
reported:
- ssd
- nearline
- enterprise (the default value for newly discovered or external volume)
- tier_capacity
- Indicates the total MDisk capacity
assigned to the volume in the tier.
Note: For thin-provisioned
copies, the capacity by tier will be 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 written to the volume before compression.
- parent_mdisk_grp_id
- Indicates the physical storage
pool id that the volume extents are actually allocated from. This
is a numeric string (between 0 and 127 characters) or blank.
- parent_mdisk_grp_name
- Indicates the physical
storage pool name that the volume extents are actually allocated from.
This is an alphanumeric string (between 1 and 63 characters) or blank.
- encrypt
- Indicates whether the volume and its
copies are encrypted. The values are yes or no.
A 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
A 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:ssd
tier_capacity:64.00MB
tier:enterprise
tier_capacity:7.94GB
compressed_copy:yesuncompressed_used_capacity:1.0MBparent_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:ssd
tier_capacity:0.00MB
tier:enterprise
tier_capacity:6.00GB
tier:nearline
tier_capacity:2.00GB
compressed_copy:no
uncompressed_used_capcaity:8.00GB
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5
encrypt:yes