lsmdisk
Use the lsmdisk command to display a concise list or a detailed view of managed disks (MDisks) visible to the system. It can also list detailed information about a single MDisk.
Syntax
Parameters
- (Optional) Specifies a list of one or more filter attributes that match the specified values; see -filtervalue? for the supported attributes. Only objects with a value that matches the filter attribute value are returned. If capacity is specified, the units must also be included. Use the unit parameter to interpret the value for size or capacity.
- (Optional) Specifies the data units for the -filtervalue
parameter.Note: -unit must be used with -filtervalue.
- (Optional) Includes all of the valid filter attributes in the report. The following
filter attributes are valid for the lsmdisk command:
- block_size
- capacity
- controller_id
- controller_name
- ctrl_LUN_#
- easy_tier_load
- id
- max_path_count
- mode
- mdisk_grp_id
- mdisk_grp_name
- name
- path_count
- quorum_index
- site_id
- site_name
- status
- tier
- UID
For more information about filtering attributes, see Attributes of the -filtervalue parameters.
- (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.
- (Optional) Specifies that you want the report to display all capacities as bytes. Capacity values that are displayed in units other than bytes might be rounded. When you filter on capacity, use a unit of bytes, -unit b, for exact filtering.
- (Optional) By default in a concise view, all columns of data are space that is
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. - (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 displays all objects that match the filtering requirements that are specified by the -filtervalue parameter.
Description
This command returns a
concise list or a detailed view of MDisks visible to the system. This table provides the
potential output for MDisks.
Note: Some of the attributes may not be applicable to your system.
Attribute | Values |
---|---|
status |
|
mode | unmanaged, managed, image, array |
quorum_index | 0, 1, 2, or blank if the MDisk is not being used as a quorum disk. |
block_size | 512, 524 bytes in each block of storage |
ctrl_type | 4 , 6 , where
6 is a flash drive that is
attached inside a node and 4 is any other device. |
tier | The tier this MDisk is assigned to by auto-detection (for
internal MDisks) or by the user:
Note: You can change this value by using the chmdisk
command.
|
easy_tier_load | This value
controls Easy Tier® settings, and is
either blank (for arrays) or one of the following values (for MDisks):
|
raid_status |
|
raid_level | The RAID level of the array (RAID0 ,
RAID1 , RAID5 , RAID6 ,
RAID10 ). |
redundancy | The number of how many member disks that fail before the array fails. |
strip_size | The strip size of the array (in KB). |
spare_goal | The number of spares that the array members must be protected by. |
spare_protection_min | The minimum number of spares that an array member is protected by. |
balanced | Describes if the array is balanced to its spare goals:
|
site_id | Indicates the site value for the MDisk. This numeric value is
1 , 2 , 3 , or blank. |
site_name | Indicates the site name for the MDisk. This is an alphanumeric value or is blank. |
fabric_type | Indicates the type of MDisk. The values are:
|
distributed | Indicates whether the array is distributed. The values are
yes or no . |
drive_class_id | Indicates the drive class that makes up this array. If -allowsuperior was used during array creation, the lowest used drive class ID is displayed. This value is blank for traditional arrays. |
drive_count | Indicates the total width of the array, including rebuild
areas. The value is a number in the range 4 - 128. The minimum value for RAID-6
and RAID-10 arrays is 6 . |
stripe_width | Indicates the width of a single unit of redundancy within a
distributed set of drives. The values are:
|
rebuild_areas_total | Indicates the total number of rebuild areas set at array creation time. These rebuild areas provide performance but no capacity. The value is a number in the range 1 - 4 for distributed array RAID-5 and RAID-6, and the value is a number in the range 2 - 4 for distributed array RAID-10 (the value is blank for traditional arrays). |
rebuild_areas_available | Indicates the number of remaining build areas within the set of arrays. The value is a number in the range 1 - 4 for distributed array RAID-5 and RAID-6, and the value is a number in the range 2 - 4 for distributed array RAID-10 (the value is blank for traditional arrays). |
rebuild_areas_goal | Indicates the rebuild areas threshold (minimum limit) at which point the array logs an error. The value is a number in the range 1 - 4 for distributed array RAID-5 and RAID-6, and a number in the range 2 - 4 for distributed array RAID-10 (the value is blank for traditional arrays). |
dedupe | Indicates that dedupe is enabled. If dedupe
is enabled, duplicate copies of repeating data are compressed or removed. |
ctrl_WWNN | Indicates the control worldwide node name (WWNN). |
preferred_WWPN | Indicates the preferred worldwide port name (WWPN). |
active_WWPN | Indicates the active WWPN. |
preferred_iscsi_port_id | Indicates the preferred I/O port identifier, which has the
same value as the preferred_WWPN value in the Fibre Channel (FC)
domain. The Internet Small Computer System Interface (iSCSI) port ID value is
displayed, but the value is blank for non-iSCSI domains. This value must be a
numeric value that can range in the range 0 - 1023. |
active_iscsi_port_id | Indicates the active I/O port identifier, which has the same value as the
active_WWPN value in the FC domain. The Internet Small Computer
System Interface (iSCSI) port ID value is displayed, but the value is blank for
non-iSCSI domains. This value must be a numeric value that can range in the range
0 - 1023. |
over_provisioned | Indicates whether the MDisk is thin-provisioned. The value is
no if the MDisk is marked as standard-provisioned. resource-provisioned, the information cannot be
verified at the backend. The value is yes or
no . |
supports_unmap | Indicates whether the mdisk is provided by a controller that
indicates that it supports unmapping. The value is no if the
MDisk indicates that it does not support unmapping or this information cannot be
verified at the backend. The value is yes or
no . |
provisioning_group_id | Indicates the allocated identifier for the provisioning group affiliated with the MDisk. The identifier lists the MDisks that are contained in the same provisioning group. The value must be an integer (number). |
physical_capacity | Indicates the total physical storage capacity of the provisioning group that contains this MDisk. If this MDisk is not over-provisioned the logical capacity is displayed here. The value must be a number (indicated in units) that is rounded to two decimal places. |
physical_free_capacity | Indicates the amount of formatted available physical space in the provisioning group that contains this MDisk. If this MDisk is not over-provisioned the remaining logical capacity is displayed instead. The value must be a number (indicated in units) that is rounded to two decimal places. |
write_protected | Shows yes if the MDisk is in the write
protected state, otherwise no . |
effective_used_capacity | The amount of logical data that is written to the MDisk. If
this MDisk is not over_provisioned , then this field is
blank. |
allocated_capacity | The amount of logical capacity that is allocated (by a pool) from this MDisk for volume data and quorum. |
Note: The automatic discovery that is performed by the system does not write
anything to an unmanaged MDisk. It is only when you add an MDisk to a storage pool, or use
an MDisk to create an image mode volume, that the system uses the storage.
To see which MDisks are available, issue the detectmdisk command to manually rescan the Fibre Channel or iSCSI network for any new MDisks. Issue the lsmdiskcandidate command to show the unmanaged MDisks. These MDisks are not assigned to a storage pool.
Notes:
The following define the status fields:
- online
- The MDisk is online and available.
- degraded
- (Internal MDisks only) The array has members that are
degraded
, or theraid_status
isdegraded
. - degraded_ports
- There are one or more MDisk port errors.
- degraded_paths
- One or more paths to the MDisk are lost; the MDisk is not online to every node in the system.
- offline
- All paths to the MDisk are lost.
- excluded
- The MDisk is excluded from use by the system; the MDisk port error count exceeded the threshold.
A concise invocation example
lsmdisk -delim :
The concise resulting output:
id:name:status:mode:mdisk_grp_id:mdisk_grp_name:capacity:ctrl_LUN_#:controller_name:UID:tier:encrypt:site_id:site_name:distributed:dedupe:over_provisioned:supports_unmap
0:mdisk0:online:managed:2:Storwize:200.0GB:0000000000000000:controller0:6005076d0281003d200000000000043e00000000000000000000000000000000:tier_enterprise:no:::no:no:no:no
6:mdisk6:online:managed:1:A9000:192.5GB:0000000000000002:controller2:6001738cfc900cef000000000001348e00000000000000000000000000000000:tier_enterprise:no:::no:yes:yes:yes
A detailed invocation example
lsmdisk mdisk1
The detailed resulting output:
id:1
name:mdisk1
status:online
mode:array
mdisk_grp_id:0
mdisk_grp_name:mdgp0
capacity:136.0GB
quorum_index:
block_size:512
controller_name:controller1
ctrl_type:4
ctrl_WWNN:200400A0B80F0702
controller_id:1
path_count:2
max_path_count:2
ctrl_LUN_#:0000000000000002
UID:600a0b80000f07020000005c45ff8a7c00000000000000000000000000000000
preferred_WWPN:200400A0B80F0703
active_WWPN:200400A0B80F0703
fast_write_state:empty
raid_status:
raid_level:
redundancy:
strip_size:
spare_goal:
spare_protection_min:
balanced:
tier:tier0_flash
slow_write_priority:latency
fabric_type:fc
easy_tier_load:low
distributed:no
drive_class_id
drive_count:8
stripe_width:4
total_rebuild_areas
available_rebuild_areas
rebuild_areas_goal
preferred_iscsi_port_id
active_iscsi_port_id
dedupe:no
flashsystem no
over_provisioned:no
supports_unmap no
provisioning_group_id
physical_capacity
physical_free_capacity
A detailed invocation example
lsmdisk 0
The resulting output:
id 0
name mdisk0
status online
mode unmanaged
...
replacement_date
over_provisioned yes
supports_unmap yes
provisioning_group_id 0
physical_capacity 13.10TB
physical_free_capacity 12.22TB
write_protected no
A detailed invocation example
lsmdisk
The resulting output:
id name status mode mdisk_grp_id mdisk_grp_name capacity ctrl_LUN_# controller_name UID tier encrypt site_id site_name distributed dedupe over_provisioned supports_unmap
0 mdisk0 online array 0 mdiskgrp0 826.4GB tier_enterprise no yes no no no
A detailed invocation example
lsmdisk -gui
The resulting output:
id name status mode mdisk_grp_id mdisk_grp_name capacity ctrl_LUN_# controller_name UID raid_status raid_level redundancy strip_size spare_goal spare_protection_min balanced tier quorum_index controller_id fabric_type encrypt site_id site_name distributed dedupe over_provisioned supports_unmap provisioning_group_id physical_capacity physical_free_capacity write_protected allocated_capacity
0 mdisk0 online array 0 mdiskgrp0 25.5TB initting raid6 2 256 0 0 exact tier0_flash 65535 no yes no no yes 25.42TB 25.42TB no 37.66TB