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 [ -filtervalue attrib=value [ -unit { b | kb | mb | gb | tb | pb } ] ] [ -nohdr ] [ -bytes ] [ -delim delimiter ] [ -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 that are displayed in units other
than bytes might be rounded. When you filter a capacity value, use a unit of bytes, -unit
b, for exact filtering. For thin-provisioned copies, the capacity by tier contains
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 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.
- -filtervalue?
- (Optional) Displays a list of valid filter attributes. The following
filters for the lsvdisk command are valid:
- access_IO_group_count
- backup_status
- capacity
- cloud_backup_enabled
- cloud_account_id
- cloud_account_name
- compressed_copy_count
- copy_count
- fast_write_state
- FC_id
- fc_map_count
- FC_name
- filesystem
- function
- id
- IO_group_id
- IO_group_name
- mdisk_grp_name
- mdisk_grp_id
- mirror_write_priority
- name
- owner_type
- owner_id
- owner_name
- preferred_node_id
- RC_change
- RC_id
- RC_name
- restore_status
- se_copy_count
- status
- type
- vdisk_UID
- volume_group_id
- volume_group_name
- volume_id
- volume_name
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 that
match the filtering requirements that are 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
actions 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 must 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 contains pinned
data is displayed. Follow the fix procedures for this event log to resolve the problem. These are
the most common causes of pinned data:
- One or more volumes in an I/O group is offline due to an asymmetric failure and contains 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 cause the system to
exlude 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 runs 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.
For onlineHyperSwap® volumes the scope
of offline copy is included with the status information. For offline volumes the
auxiliary copy is included with the status information even if the copy associated with that is
online.
- 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
volumes. 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.
- throttle_ID
- Indicates the ID for the throttle object. The value is a numeric string in the range 0 - 10241
(or is blank if no throttle is configured).
- throttle_name
- Indicates the name of the throttle object. The value is an alphanumeric string in the range 1 -
63 characters or blank if no throttle is specified.
- IOPs_limit
- Indicates the IOPs limit that is configured for the volume. The value is an numeric string or
blank if no limit is specified.
- bandwidth_limit_MB
- Indicates the bandwidth limit configured (in MB) for the volume. The value is a numeric string
or is blank if no limit is configured.
- preferred_node_id
- Indicates the node that processes 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 that are 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 that owns this volume; otherwise, it is blank.
- mirror_write_priority
- Indicates the mirror write algorithm priority 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 that 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 value 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 that is 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 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).
This table displays possible values and related information for
easy_tier_status:
- tier
- The tier information being reported:
- tier0_flash
- tier1_flash
- tier_enterprise
- tier_nearline
- tier_capacity
- 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 if the volume copy is compressed.
- uncompressed_used_capacity
- For compressed volumes, indicates the amount of data that is written to the volume before
compression.
- block_size
- Indicates the volume block sizes.
- 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 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.
- 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 ID 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
that contains 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
- volume_group_id
- Indicates a volume group ID for a volume group that a volume belongs to. The value must be a
number.
- volume_group_name
- Indicates the volume group name for a volume group that a volume belongs to. The value must be
an alphanumeric string.
- cloud_backup_enabled
- Indicates whether the cloud snapshot feature is enabled for the specified volume. The
values are yes or no.
- cloud_account_id
- Indicates the cloud account ID. The value must be a number.
- cloud_account_name
- Indicates the cloud account name. The value must be an alphanumeric string.
- backup_status
- Indicates whether a new cloud snapshot can be started. If a backup is in progress, the
status of the backup operation is given. The values are:
- off
- ready
- copying
- copying_error
- not_ready
- last_backup_time
- Indicates the time of the most recent backup or snapshot for the specified volume. The value
must be in YYMMDDHHMMSS format (or blank).
- restore_status
- Indicates whether a restore can be performed for the volume. If a restore is in progress, the
status of the restore operation is given. The values are:
- none
- available
- restoring
- restoring_error
- committed
- committing
- committing_error
- backup_grain_size
- Indicates the grain size for the volume mappings that are used for the cloud snapshot function.
The value is blank if cloud snapshot is not enabled.
Note: This sizing does not reflect the size of
the grains that are stored in the cloud (which are fixed at 256 KB).
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
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: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_capacity:1000.00MB
last_access_time:140604171325
throttle_id:1
throttle_name:lcyfoxes_1
IOPs_limit:25000
bandwidth_limit_MB:500volume_group_id:1
volume_group_name:ZlaIbra2cloud_backup_enabled:no
cloud_account_id:
cloud_account_name:
backup_status:off
last_backup_time:
restore_status:available
backup_grain_size:
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:no:0: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
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:p5encrypt: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: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
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: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
last_access_time 140604171325
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5throttle_id:1
throttle_name:lcyfoxes_1
IOPs_limit:25000
bandwidth_limit_MB:500volume_group_id:1
volume_group_name:ZlaIbra2cloud_backup_enabled:no
cloud_account_id:
cloud_account_name:
backup_status:off
last_backup_time:
restore_status:available
backup_grain_size:
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
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 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_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 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_capacity:2.00GB
last_access_time 140604171325
parent_mdisk_grp_id:5
parent_mdisk_grp_name:p5throttle_id:1
throttle_name:lcyfoxes_1
IOPs_limit:25000
bandwidth_limit_MB:500volume_group_id:1
volume_group_name:ZlaIbra2cloud_backup_enabled:no
cloud_account_id:
cloud_account_name:
backup_status:off
last_backup_time:
restore_status:available
backup_grain_size: