lsmdisk

Use the lsmdisk command to display a concise list or a detailed view of managed disks (MDisks) visible to the clustered system (system). It can also list detailed information about a single MDisk.

Syntax


>>- lsmdisk -- ------------------------------------------------->

>--+-------------------------------------------------------------+- -->
   '- -filtervalue -- attribute=value -- --+-------------------+-'     
                                           '- -unit --+- b --+-'       
                                                      +- kb -+         
                                                      +- mb -+         
                                                      +- gb -+         
                                                      +- tb -+         
                                                      '- pb -'         

>--+-----------------+-- --+----------+- -+----------+- -------->
   '- -filtervalue? -'     '- -nohdr -'   '- -bytes -'     

>--+-----------------------+-- --+---------------+-------------><
   '- -delim -- delimiter -'     +- object_id ---+   
                                 '- object_name -'

Parameters

-filtervalue attribute=value

(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.

Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards with the system CLI:

The wildcard character is an asterisk (*).
The command can contain a maximum of one wildcard, which must be the first or last character in the string.
When you use a wildcard character, you must enclose the filter entry within double quotation marks (""), as follows:
```
lsmdisk -filtervalue  "name=md*"
```

-unit b | kb | mb | gb | tb | pb

(Optional) Specifies the data units for the -filtervalue parameter.

Note: -unit must be used with -filtervalue.

-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

Any parameters that are specified with the -filtervalue? parameter are ignored.

For more information about filtering attributes, see Attributes of the -filtervalue parameters.

-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) 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.

-delim delimiter

(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.

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 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. Table 1 provides the potential output for MDisks.

Note: Some of the attributes may not be applicable to your system.

Table 1. MDisk output
Attribute	Values
status	`online` `offline` `excluded` `degraded_paths` `degraded_ports` `degraded` (This value applies only to internal MDisks.)
mode	unmanaged, managed, image
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: `tier0_flash` `tier1_flash` `tier_enterprise` `tier_nearline` Note: You can change this value by using the chmdisk command.
easy_tier_load	This value controls Easy Tier® settings, and is one of the following values (for MDisks): `low` `medium` `high` `very_high`
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: exact All populated members have exact capability match, exact location match. yes All populated members have at least exact capability match, exact chain, or different enclosure or slot. no Anything else that is not included for `yes` or `exact`.
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: `fc` indicates that it is an MDisk from an FC controller. `sas_direct` indicates that it is an MDisk from an SAS direct-attached controller. `iscsi` indicates that it is an iSCSI controller.
encrypt	Indicates whether the data stored on the MDisk group is encrypted or not encrypted. The values are: `yes` indicates that the pool has an encryption key. `no` indicates that the pool does not have an encryption key but it contains an MDisk or MDisks that are encrypted. Blank if the pool doesn't have an encryption key and the pool has no MDisks.
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: Any number in the range 3 - 16 for RAID-5 arrays. Any number in the range 4 - 16 for RAID-6 arrays. An even number in the range 2 - 16 for RAID-10 arrays.
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 fully allocated. 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.

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:

A system connection from a node or node canister port to a storage controller port for a single MDisk is a path. The Mdisk path_count value is the number of paths currently being used to submit input/output (I/O) to this MDisk.
The MDisk max_path_count value is the highest value path_count reaches since the MDisk was last fully online.
The preferred_WWPN is one of the World Wide Port Names (WWPNs) the storage controller specifies as a preferred WWPN. If the controller has nothing that is specified, this is a blank field.
The active_WWPN indicates the WWPN of the storage controller port currently being used for I/O.
1. If no storage controller ports are available for I/O, this is a blank field.
2. If multiple controller ports are actively being used for I/O, this field's value is many.

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 the raid_status is degraded.
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
encryt:no
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