Use the lssevdiskcopy command to list
the thin-provisioned copies of the specified volumes.
Syntax
lssevdiskcopy
[ -nohdr ]
[ -bytes
] [ -delim delimiter
] [ -copy id
] [ -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:
- tier0_flash
- tier1_flash
- tier_enterprise
- tier_nearline
- 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: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:ssd
tier_capacity:2.00GB
compressed_copy:yes
uncompressed_used_capacity:3.27GB
parent_mdisk_grp_id:10
parent_mdisk_grp_name:pool10encrypt:yes
An invocation example
lssevdiskcopy -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_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:10
parent_mdisk_grp_name:pool10encrypt:yes