Use the lssevdiskcopy command to list the thin-provisioned copies of the specified volumes.
Syntax
lssevdiskcopy
[ -nohdr ]
[ -bytes ]
[ -delimdelimiter ]
[ -copyid
] [ -filtervalue? ] [ { 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.
- -copyid
- (Optional) Specifies the volume copy to list thin-provisioned
copies 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 lssevdiskcopy command are valid:
- mdisk_grp_id
- mdisk_grp_name
- overallocation
- autoexpand
- grainsize
- vdisk_name | vdisk_id
- (Optional) Specifies the volume name or ID 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 the primary copy is deleted
once the secondary copy is synchronized. The values are yes or no.
- primary
- Indicates whether the voume 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.
- 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.
- free_capacity
- Indicates the difference between
the real_capacity and used_capacity values.
- 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, 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.
- grainsize
- For thin-provisioned volume copies,
indicates the grain size chosen for the volume copy when it was created.
Remember: This field is always
blank for compressed volume copies.
- se_copy
- Indicates if 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:
- 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.
- 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 (see note 2) |
| 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 |
active (see note 5) |
| Auto |
Two |
On |
measured (see note 3) |
| 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(tm) status
is measured instead of active.
- When the volume copy status is inactive, no Easy Tier(tm) functions are enabled for that volume
copy.
- When the volume copy status is measured, the Easy Tier(tm) function collects usage statistics for
the volume but automatic data placement is not active.
- When the volume copy
status is balanced, the Easy Tier(tm) function enables performance-based pool balancing for that volume
copy.
- When the volume copy status is active, the Easy Tier(tm) function operates in automatic data
placement mode for that volume.
- The default Easy Tier(tm) setting
for a storage pool is auto, and the default Easy Tier(tm) setting for a volume copy is on. This means that Easy Tier(tm) 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.
An invocation example
lssevdiskcopy delim :
The resulting output:
vdisk_id:vdisk_name:copy_id:mdisk_grp_id:mdisk_grp_name:capacity:used_capacity:real
_capacity:
free_capacity:overallocation:autoexpand:warning:grainsize:se_copy:compressed_copy:uncompressed_used_capacity
0:vv1:0:0:ppp:16.00GB:2.00GB:2.01GB:6.00GB:796:off:20:32:no:yes:3.27GB
1:se1:0:0:ppp:16.00GB:1.00GB:4.00GB:15.00GB:400:off:20:32:yes:no:1.0GB:yes:no:1.0GB
1:se1:1:0:ppp:16.00GB:2.00GB:2.01GB:14.00GB:796:off:45:256:no:yes:4.46GB
An invocation example
lssevdiskcopy -delim : -copy 0 0
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:2.01GB
free_capacity:6.00GB
overallocation:796
autoexpand:on
warning:25
grainsize:256
se_copy:yes
easy_tier:on
easy_tier_status:active
tier:enterprise
tier_capacity:64.00MB
tier:ssd
tier_capacity:2.00GB
compressed_copy:yes
uncompressed_used_capacity:3.27GB
parent_mdisk_grp_id:10
parent_mdisk_grp_name:pool10
encrypt:yes
An invocation example
lssevdiskcopy -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:10
parent_mdisk_grp_name:pool10
encrypt:yes