lsvdisk
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
- -filtervalue attrib=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.
- -unit b | 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.
- -delim delimiter
- (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:
- access_IO_group_count
- capacity
- 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
- se_copy_count
- status
- type
- vdisk_UID
- 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 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.
- 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.
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 online HyperSwap® 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 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.
- throttle_ID
- Indicates the ID for the throttle object. The value is a numeric string from 0 to 10241 (or is blank if no throttle is configured).
- throttle_name
- Indicates the name of the throttle object. The value is an alphanumeric string 1 to 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 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 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. Note: If Easy Tier is disabled because a node in the system does not have the required 8 GB RAM, the easy_tier_status is inactive.
- 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:
- tier0_flash
- tier1_flash
- tier_enterprise
- tier_nearline
- 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.
- 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
- 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.
- volume_id
- Indicates the volume ID (for a high availability volume). This must be a numerical value.
- volume_name
- Indicates the volume name (for a high availability volume). This must be an alphanumeric string containing up to 63 characters.
- function
- Indicates the function of the volume in the remote copy relationship. Remote copy includes Metro Mirror and Global Mirror.
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
lsvdisk -delim : vv45
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:p5
owner_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:500
A concise invocation example
lsvdisk -delim :
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
lsvdisk -delim : vv1
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:p5
owner_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:p5
throttle_id:1
throttle_name:lcyfoxes_1
IOPs_limit:25000
bandwidth_limit_MB:500
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
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:p5
throttle_id:1
throttle_name:lcyfoxes_1
IOPs_limit:25000
bandwidth_limit_MB:500