The lsvdisk command displays a concise list or a detailed view of VDisks that are recognized by the cluster.
The list report style can be used to obtain two different
styles of report.
- A list containing concise information about all the virtual disks that are recognized by the cluster. (Each entry in the list corresponds to a single virtual disk.)
- The detailed information about a single virtual disk.
Syntax
>>- svcinfo -- -- lsvdisk -- -----------------------------------> >--+--------------------------------+-- --+----------+-- -------> '- -filtervalue -- attrib=value -' '- -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.
- -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.
- -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.
- 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.
- -filtervalue?
- (Optional) Displays a list of valid filter attributes. The following
filters for the svcinfo lsvdisk command are valid:
- vdisk_name
- vdisk_id
- vdisk_UID
- fc_map_count
- copy_count
- IO_group_id
- IO_group_name
- status
- mdisk_grp_name
- mdisk_grp_id
- capacity
- type
- FC_id
- FC_name
- RC_id
- RC_name
- name
- id
Note: It is not possible to filter the svcinfo lsvdisk command with mdisk_grp_name=many to identify mirrored VDisks. Instead, filter on copy_count=2.
Description
This command displays a concise list or a detailed view of attributes for all VDisks and VDisk copies in the cluster.
The VDisk 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 VDisk.
- All synchronized copies for this VDisk are in MDisk groups that are offline.
- The VDisk 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 MDisk group that the VDisk spans. In this case MDisks are shown as degraded and the DMPs for MDisks should be followed to resolve the problem.
- The fast write cache pins data for one or more VDisks 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 directed maintenance procedures for this error log to resolve
the problem. The most common causes of pinned data are the following:
- One or more VDisks 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 SAN fabric faults or misconfiguration, back-end controller faults or misconfiguration or because repeated errors has lead to the cluster excluding access to a MDisk through one or more nodes.
- One or more VDisks in an I/O group is offline due to a problem with a FlashCopy® mapping.
The command returns values for the following VDisk attributes:
- IO_groups_id/name
- Specifies the I/O Group that the VDisk belongs to.
- status
- The value can be online, offline or degraded.
- mdisk_grp_id/name
- Specifies the name and ID of the MDisk group that the VDisk belongs to. If the VDisk has more than one copy, these fields display many.
- type
- Specifies the virtualization type of the VDisk. The value can be striped, sequential, image or many. The value many indicates that the VDisk has more than one copy, which can have different virtualization types.
- capacity
- Specifies the total capacity of the VDisk.
- formatted
- Indicates whether the VDisk was formatted when it was created. The value can be Yes or No.
- mdisk_id/name
- Specifies the MDisk that is used for sequential and image mode VDisks. If the VDisk has more than one copy, these fields display many.
- FC_id/name
- Specifies the name and ID of the FlashCopy mapping that the VDisk belongs to. The value many indicates that the VDisk belongs to more than one FlashCopy mapping.
- RC_id/name
- Specifies the name and ID of the Global Mirror or Metro Mirror relationship that the VDisk belongs to.
- vdisk_UID
- Specifies the UID of the VDisk.
- throttling
- Specifies the throttle rate of the VDisk.
- preferred_node_id
- Specifies the ID of the preferred node for the VDisk.
- fast_write_state
- Specifies the cache state for the VDisk. The value can be empty, not_empty, corrupt, or repairing. A cache state of corrupt indicates that the VDisk 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.
- cache
- Specifies the cache mode of the VDisk. The value can be readwrite or none.
- udid
- Specifies the unit number for the VDisk. Only OpenVMS hosts require a unit number.
- fc_map_count
- Specifies the number of FlashCopy mappings that the VDisk belongs to.
- sync_rate
- Specifies the rate for synchronization for mirrored copies.
The command returns values for the following
VDisk copy attributes:
- copy_id
- Specifies a system-assigned identifier for the VDisk copy. The value can be 0 or 1.
- status
- The value can be online or offline. A copy is offline if all nodes cannot access the MDisk group that contains the copy.
- sync
- Indicates whether the VDisk copy is synchronized.
- primary
- Indicates whether the VDisk copy is the primary copy. A VDisk has exactly one primary copy. The value can be Yes or No.
- mdiskgrp_id/name
- Specifies the name and ID of the MDisk group that the VDisk copy belongs to.
- type
- Specifies the virtualization type of the VDisk. The value can be striped, sequential or image.
- mdisk_id/name
- Specifies the MDisk that is used for sequential and image mode VDisks.
- fast_write_state
- Specifies the cache state of the VDisk copy. The value can be empty, not_empty, corrupt, or repairing. The value is always empty for non-space-efficient copies. A cache state of corrupt indicates that the VDisk is space-efficient and requires repair that is initiated by a recovervdisk command or the repairsevdiskcopy command.
- used_capacity
- Specifies the portion of real_capacity that is being used to store data. For non-space-efficient copies, this value is the same as the VDisk capacity. If the VDisk copy is space-efficient, the value increases from zero to the real_capacity value as more of the VDisk is written to.
- real_capacity
- Specifies the amount of physical storage that is allocated from an MDisk group to this VDisk copy. If the VDisk copy is not space-efficient, the value is the same as the VDisk capacity. If the VDisk copy is space-efficient, the value can be different.
- free_capacity
- Specifies the difference between the real_capacity and used_capacity values.
- overallocation
- Expressed as a percentage, specifies the ratio of VDisk capacity to real_capacity values. This value is always 100 for non-space-efficient VDisks.
- autoexpand
- Specifies whether autoexpand is enabled on a space-efficient VDisk. The value can be on or off.
- warning
- Expressed as a percentage, for space-efficient VDisk copies only. A warning is generated when the ratio of used_capacity to VDisk capacity reaches the specified level.
- grainsize
- For space-efficient VDisk copies, specifies the grain size chosen for the VDisk copy when it was created.
A concise invocation example
svcinfo lsvdisk -delim :
The concise 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 0:vdisk0:0:io_grp0:degraded:0:mdiskgrp0:16.0MB:striped:::::60050768017F06BF7800000000000000:1 1:vdisk1:0:io_grp0:degraded:0:mdiskgrp0:16.0MB:striped:::::60050768017F06BF7800000000000001:1 2:vdisk2:0:io_grp0:degraded:0:mdiskgrp0:16.0MB:striped:::::60050768017F06BF7800000000000002:1 3:vdisk3:0:io_grp0:degraded:0:mdiskgrp0:16.0MB:striped:::::60050768017F06BF7800000000000003:1
A detailed invocation example
svcinfo lsvdisk -delim : 251
The detailed resulting output
id:251 name:i0vd163 IO_group_id:0 IO_group_name:io_grp0 status:online mdisk_grp_id:3 mdisk_grp_name:vind1 capacity:16.0MB type:striped formatted:no mdisk_id: mdisk_name: FC_id: FC_name: RC_id: RC_name: vdisk_UID:6005076801A0002C800000000000078B throttling:0 preferred_node_id:1 fast_write_state:empty cache:readwrite udid: fc_map_count:0 sync_rate:50 copy_count:1 copy_id:0 status:online sync:yes primary:yes mdisk_grp_id:3 mdisk_grp_name:vind1 type:striped mdisk_id: mdisk_name: fast_write_state:empty used_capacity:16.00MB real_capacity:16.00MB free_capacity:0.00MB overallocation:100 autoexpand: warning: grainsize: