Use the lsvdisk command to display a
concise list or a detailed view of volumes that
are recognized by the clustered system (system).
Syntax
lsvdisk
[ -filtervalueattrib=value
[ -unit { b | kb
| mb | gb | tb | pb }
] ] [ -nohdr ]
[ -bytes ]
[ -delimdelimiter ]
[ -filtervalue? ] [ { object_id | object_name
} ]
Parameters
- -filtervalueattrib=value
- (Optional) Specifies a list of one or more filters.
Only objects with a value that matches the filter attribute value
are displayed. If a capacity is specified, the units must also be
included.
- -unitb | kb | mb | gb | tb | pb
- (Optional) Specifies
the data units for the -filtervalue parameter.
Note: -unit must be used with -filtervalue.
- -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. When filtering on capacity, use a unit
of bytes, -unit b, for exact filtering. For thin-provisioned copies, the capacity by tier
will be the real capacities.
- -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.
- -filtervalue?
- (Optional) Displays a list of valid filter
attributes. The following filters for the lsvdisk command are valid:
- name
- id
- IO_group_id
- IO_group_name
- status
- mdisk_grp_name
- mdisk_grp_id
- capacity
- type
- FC_id
- FC_name
- RC_id
- RC_name
- vdisk_UID
- fc_map_count
- copy_count
- fast_write_state
- se_copy_count
- filesystem
- preferred_node_id
- mirror_write_priority
- RC_change
- compressed_copy_count
- access_IO_group_count
- owner_type
- owner_id
- owner_name
- volume_id
- volume_name
- function
Note: It is not possible to filter the lsvdisk command with mdisk_grp_name=many to identify mirrored
volumes. Instead, filter on copy_count=2.
- object_id | object_name
- (Optional) Specifies the name or ID of an object. When you use this
parameter, the detailed view of the specific object is returned and
any value that is specified by the -filtervalue parameter is ignored. If you do not specify the object_id
| object_name parameter, the concise view of all objects
matching the filtering requirements that is specified by the -filtervalue parameter are displayed.
Description
This command
displays a concise list or a detailed view of attributes for all volumes
and volume copies in the system.
The
volume is offline
and unavailable if one of the following takes place:
- Both nodes in the I/O group are missing.
- None of the nodes in the I/O group that are present can access
the volume.
- All synchronized copies for this volume are in storage pools that
are offline.
- The volume is formatting.
If you have a degraded volume and all of the associated nodes
and MDisks are online, refer to your product support information
for assistance. A volume is reported as degraded if any of the
following occurs:
- One of the nodes in the I/O group is missing.
- One of the nodes in the I/O group cannot access all the MDisks
in the storage pool that the volume spans. In this case MDisks are
shown as degraded and the fix procedures for MDisks should be followed
to resolve the problem.
- The fast write cache pins data for one or more
volumes in the I/O group and is unable to perform a failback until
the situation is resolved. An error log indicating that the cache
has pinned data is displayed. Follow the fix procedures for this event
log to resolve the problem. The most common causes of pinned data
are the following:
- One or more volumes in an I/O group is offline
due to an asymmetric failure and has pinned data in the cache. Asymmetric
failures can occur because of fabric faults or misconfiguration, back-end
controller faults or misconfiguration or because repeated errors has
led to the system excluding access to a MDisk
through one or more nodes.
- One or more volumes in an I/O group is offline
due to a problem with a FlashCopy mapping.
- A thin-provisioned disk has run out of space.
You can encrypt volumes and volume copies. The volume
is encrypted if all volume copies are also encrypted.
Note: This means
that during a migration of a volume (with one copy) between an encrypted
and unencrypted storage pool the value is no.
The volume is not encrypted if the storage pool has a value of
encrypt:no, including if the volume's extents are part of
an encrypted MDisk or sequential volume.
The command returns
values for the following volume attributes:
- IO_groups_id
- Indicates the I/O group (ID) that
the volume belongs to.
- IO_groups_name
- Indicates the I/O group (name)
that the volume belongs to.
- status
- Indicates the status. The value can be online, offline or degraded.
- mdisk_grp_id
- Indicates the ID of the storage pool that the volume belongs to. If the volume has more than one
copy, these fields display many.
- mdisk_grp_name
- Indicates the name of the storage pool that the volume belongs to. If the volume has more than one
copy, these fields display many.
- type
- Indicates the virtualization type of the volume. The value can be striped, seq, image or many. The value many indicates that the volume has more than one copy, which can have different virtualization
types.
- capacity
- Indicates the total capacity of the volume.
- formatted
- Indicates whether the volume was formatted
when it was created. The value can be yes or no.
- formatting
- Indicates whether the volume is formatting.
The value can be yes or no.
- mdisk_id
- Indicates the MDisk ID that is used
for sequential and image mode volume s. If the volume has more than
one copy, these fields display many.
- mdisk_name
- Indicates the MDisk name that is used
for sequential and image mode volumes. If the volume has more than
one copy, these fields display many.
- FC_id
- Indicates the ID of the FlashCopy mapping
that the volume belongs to. The value many indicates
that the volume belongs to more than one FlashCopy mapping.
- FC_name
- Indicates the name of the FlashCopy mapping
that the volume belongs to. The value many indicates
that the volume belongs to more than one FlashCopy mapping.
- RC_id
- Indicates the ID of the
remote copy relationship that the volume belongs to. The value must
be numerical.
- RC_name
- Indicates the name of
the remote copy relationship that the volume belongs to.
- vdisk_UID
- Indicates the UID of the volume.
- throttling
- Indicates the throttle rate of the volume.
- preferred_node_id
- Indicates the node processing
the I/O data.
Remember: This value must be numeric.
(The value is zero if no node is configured in the I/O group that
contains the preferred node.)
- fast_write_state
- Indicates the cache state for
the volume. The value can be empty, not_empty, corrupt, or repairing. A cache
state of corrupt indicates that the volume requires
recovery by using one of the recovervdisk commands.
A cache state of repairing indicates that repairs
initiated by a recovervdisk command are in progress.
- Indicates the cache state for the volume or volume copy. The value
can be empty, not_empty, corrupt, or repairing. A cache state of corrupt indicates that the volume or volume copy requires
repairing or recovery by using either the recovervdisk or repairvdiskcopy command.
- cache
- Indicates the cache mode of the volume.
The value can be readonly, readwrite, or none.
- udid
- Indicates the unit number for the volume. Only OpenVMS hosts require a unit number.
- fc_map_count
- Indicates the number of FlashCopy
mappings that the volume belongs to.
- sync_rate
- Indicates the rate for synchronization
for mirrored copies.
- se_copy_count
- Indicates the number of thin-provisioned
copies.
Remember: This
value represents only thin-provisioned copies and is not used for
compressed volume copies.
- filesystem
- Expressed as a value string (long
object name with a maximum of 63 characters), indicates the full name
for file system which owns this volume; otherwise,
it is blank.
- mirror_write_priority
- Indicates the mirror write
algorithm priority being used if the volume is mirrored.
- RC_change
- Indicates if a volume is a change volume
of a remote copy relationship.
- compressed_copy_count
- Indicates the number of
compressed volume copies.
- access_IO_group_count
- Indicates the number of
I/O groups in the volume access set.
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 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, seq, 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.
- 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 of the
volume capacity, indicates the ratio of volume capacity to real_capacity values. This value is
always 100 for non-thin-provisioned or compressed volumes.
Remember: This value can be any percentage (but not blank)
for compressed volume copies.
- autoexpand
- Indicates whether autoexpand is enabled on a thin-provisioned volume.
The value can be on or off.
Remember: This value cannot
be blank for compressed copies.
- warning
- Expressed as a percentage of the volume
capacity, this indicates a warning for thin-provisioned or compressedvolume copies. A warning is generated when the ratio
of used_capacity to volume capacity reaches the specified level.
Remember: This value can be any percentage for
compressed volume copies.
- grainsize
- For thin-provisioned volume copies, indicates the grain size chosen for the volume copy when it was created.
Remember: This value is always
blank for compressed volume copies.
- se_copy
- Indicates if the copy is thin-provisioned.
Remember: This value is yes for thin-provisioned copies and no for compressed
volume copies.
- easy_tier
- This value is set by the user and 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).
This table displays possible
values and related information for
easy_tier_status:
Table 1. Easy Tier status values. Easy Tier status values
| 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 |
measured (see note 3) |
| Auto |
Two |
On |
(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(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
- The tier information being reported:
- ssd
- nearline
- enterprise (the default value for newly discovered or external volume)
- tier_capacity
- 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 if the volume copy
is compressed.
- uncompressed_used_capacity
- For compressed volumes,
indicates the amount of data written to the volume before compression.
- block_size
- Indicates the volume block size.
- last_access_time
- Indicates the time (YYMMDDHHMMSS) the volume last received Small Computer System
Interface (SCSI) commands from any mapped host.
- 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.
- owner_type
- Indicates the type of owning component
or object (such as a file system). The values are:
- filesystem
- host_integration_metadata
- vvol
- none
The value is none if no owner is assigned.
- owner_id
- Indicates an identification number for
the owning object. This value must be a numeric character unless there
is no owning object (in which case it is blank).
- owner_name
- Indicates the name for owning object
that owns this volume. The value must be a set of up to 63 alphanumeric
characters, but is blank if there is no owning object.
- encrypt
- Indicates whether all copies of a volume
reside in MDisk groups (storage pools) that are reported as encrypting.
This means that either one of the following things apply:
- The copies reside in a storage pool that has an encryption key.
- All MDisks in the group are self-encrypting or encrypted for RAID.
The values are yes and no.
- volume_id
- Indicates the volume ID (for a high
availability volume). This must be a numerical value. For a basic volume, the volume ID is the same as the vdisk_UID. For a HyperSwap® volume (involved in an active-active relationship),
the volume ID is the same as the master volume.
- volume_name
- Indicates the volume name (for a
high availability volume). This must be an alphanumeric string containing
up to 63 characters. For a basic volume, the volume name is the same as the vdisk_UID. For a HyperSwap volume (involved in an active-active relationship),
the volume name is the same as the master volume.
- function
- Indicates the function of the volume
in the remote copy relationship. Remote copy
includes Metro Mirror, Global Mirror, and HyperSwap.
The values are:
- master, which indicates a master volume in a
remote copy relationship.
- aux, which indicates an auxiliary volume in a
remote copy relationship.
- master_change, which indicates a change volume
for a master volume in a remote copy relationship.
- aux_change, which indicates a change volume for
an auxiliary volume in a remote copy relationship
- Blank, which indicates that the volume is not in any remote copy
relationship
A detailed invocation example
for a volume
The resulting output:
name:vv45
IO_group_id:0
IO_group_name:io_grp0
status:online
mdisk_grp_id:0
mdisk_grp_name:Group0
capacity:1000.00MB
type:striped
formatted:no
formatting:yes
mdisk_id:
mdisk_name:
FC_id:
FC_name:
RC_id:
RC_name:
vdisk_UID:60050768019B82328000000000000010
throttling:0
preferred_node_id:2
fast_write_state:empty
cache:readwrite
udid:
fc_map_count:0
sync_rate:50
copy_count:1
se_copy_count:0
filesystem:
mirror_write_priority:redundancy
RC_change:no
compressed_copy_count:0
access_IO_group_count:1
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5encrypt:yesvolume_id:0
volume_name:homer0
function:auxowner_type filesystem
owner_id 2
owner_name myfilesystem2
copy_id:0
status:online
sync:yes
auto_delete:yes
primary:yes
mdisk_grp_id:0
mdisk_grp_name:Group0
type:striped
mdisk_id:
mdisk_name:
fast_write_state:empty
used_capacity:1000.00MB
real_capacity:1000.00MB
free_capacity:0.00MB
overallocation:100
autoexpand:
warning:
grainsize:
se_copy:no
easy_tier:on
easy_tier_status:inactive
tier:generic_ssd
tier_capacity:0.00MB
tier:generic_hdd
tier_capacity:1000.00MB
compressed_copy:no
uncompressed_used_capacity:1000.00MBlast_access_time 140604171325
A concise invocation example
The resulting output:
id:name:IO_group_id:IO_group_name:status:mdisk_grp_id:mdisk_grp_name:capacity:type:
FC_id:FC_name:RC_id:RC_name:vdisk_UID:fc_map_count:copy_count:
fast_write_state:se_copy_count:RC_change:compressed_copy_count:volume_id:volume_name:funtion
0:vdisk0:0:io_grp0:degraded:0:mdiskgrp0:10.00GB:striped:::::60050768018300003000000000000000:0:1:empty:0:no0:1:VDisk1:aux_change
A detailed invocation example
The resulting output:
id:0
name:vv1
IO_group_id:0
IO_group_name:io_grp0
status:degraded
mdisk_grp_id:many
mdisk_grp_name:many
capacity:16.00GB
type:many
formatted:no
formatting:yes
mdisk_id:many
mdisk_name:many
FC_id:
FC_name:
RC_id:
RC_name:
vdisk_UID:00000000000000AB:6005076801CF003F2800000000000000
throttling:0
preferred_node_id:1
fast_write_state:empty
cache:readwrite
udid:1234
fcmap_count:0
sync_rate:25
copy_count:2
se_copy_count:1filesystem:
mirror_write_priority:redundancy
RC_change:no
compressed_copy_count:0
access_IO_group_count:1
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5
encrypt:yesvolume_id:1
volume_name:slayer1
function:auxowner_type filesystem
owner_id 2
owner_name myfilesystem2
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:corrupt
used_capacity:8.00GB
real_capacity:8.00GB
free_capacity:6.00GB
overallocation:100
autoexpand:off
warning:
grainsize:
se_copy:no
easy_tier:off
easy_tier_status:inactive
tier:generic_ssd
tier_capacity:0.00MB
tier:generic_hdd
tier_capacity:8.00GB
copy_id:1
status:offline
sync:no
primary:no
mdisk_grp:2
mdisk_grp_name:mdisk_group_2
type:striped
mdisk_id:
mdisk_name:
fast_write_state:not_empty
used_capacity:2.00GB
real_capacity:4.00GB
free_capacity:2.00GB
overallocation:400
autoexpand:on
warning:20
grainsize:256
se_copy:yes
easy_tier:on
easy_tier_status:active
tier:generic_ssd
tier_capacity:64.00MB
tier:generic_hdd
tier_capacity:3.94GB
last_access_time 140604171325parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5
An invocation example
lsvdisk -delim : vv2
The resulting ouput:
id:0
name:vv2
IO_group_id:0
IO_group_name:io_grp0
status:degraded
mdisk_grp_id:many
mdisk_grp_name:many
capacity:16.00GB
type:many
formatted:no
formatting:yes
mdisk_id:many
mdisk_name:many
FC_id:
FC_name:
RC_id:
RC_name:
vdisk_UID:00000000000000AB:6005076801CF003F2800000000000000
throttling:0
preferred_node_id:1
fast_write_state:empty
cache:readwrite
udid:1234
fc_map_count:0
sync_rate:25
copy_count:2
se_copy_count:2
filesystem:
mirror_write_priority:latency
RC_change:no
compressed_copy_count:0
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5
encrypt:yesvolume_id:0
volume_name:vv2
function:master
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_capacity:2.00GB
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5
copy_id:1
status:offline
sync:no
primary:no
mdisk_grp_id:2
mdisk_grp_name:mdisk_group_2
type:striped
mdisk_id:
mdisk_name:
fast_write_state:not_empty
used_capacity:2.00GB
real_capacity:4.00GB
free_capacity:2.00GB
overallocation:400
autoexpand:on
warning:20
grainsize:256
se_copy:yes
easy_tier:off
easy_tier_status:inactive
tier:ssd
tier_capacity:0.00MB
tier:enterprise
tier_capacity:2.00GB
tier:nearline
tier_capacity:2.00GB
compressed_copy:no
uncompressed_used_capacity:2.00GB
last_access_time 140604171325parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5