lssevdiskcopy

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 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.

-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 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.

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 that is 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 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.
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).

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 svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__inactive)
Off	One	On	inactive (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__inactive)
Off	Two	Off	inactive (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__inactive)
Off	Two	On	inactive (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__inactive)
Measure	One	Off	measured (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__measured)
Measure	One	On	measured (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__measured)
Measure	Two	Off	measured (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__measured)
Measure	Two	On	measured (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__measured)
Auto	One	Off	measured (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__measured)
Auto	One	On	balanced (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__balanced)
Auto	Two	Off	active (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__active)
Auto	Two	On	measured (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__measured)
On	One	Off	measured (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__measured)
On	One	On	balanced (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__balanced)
On	Two	Off	measured (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__measured)
On	Two	On	active (see note svc_lssevdiskcopy_3r5om0.html#svc_lssevdiskcopy_3r5om0__active)
Note: If the volume copy is in image or sequential mode or is being migrated, 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 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

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