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

-delim delimiter: (Optional) Specify a delimiter to separate data in the output.
-nohdr: (Optional) Suppress the headings in the output.
-filtervalue attribute=value: (Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
-filtervalue?: (Optional) Displays a list of valid filter attributes.

-unit b | kb | mb | gb | tb | pb: (Optional) Specifies the data units for the -filtervalue parameter.
Note: -unit must be used with -filtervalue.
-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.
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. This table 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, 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: `tier0_flash` `tier1_flash` `tier_enterprise` `tier_nearline` `tier_scm` 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): `low` `medium` `high` `very_high`
raid_status	offline Array is offline on all nodes. degraded Array has deconfigured or offline members; the array is not fully redundant. syncing Array members are all online. The array is syncing parity or mirrors to achieve redundancy. initting Array members are all online. The array is initializing; the array is fully redundant. online Array members are all online and the array is fully redundant. expanding The array members are all online and the array is expanding.
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 (Deprecated)	The value of this attribute is always `blank`.
spare_protection_min (Deprecated)	The value of this attribute is always `blank`.
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.
distributed (Deprecated)	Indicates whether the array is distributed. The value of this attribute is always `yes`.
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 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.
fips_enabled	Indicates whether the mdisk follows FIPS standards. The value is `yes` or `no`.

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.Errors are detected on the Fibre Channel (FC) network that connects the storage. The ports that are causing the errors are excluded from the configuration.
degraded_paths: One or more paths to the MDisk are lost; the MDisk is not online to every node in the system.One or more nodes in the configuration lost contact with the specified MDisk or array because of an FC connectivity issue (or because of the LUN mapping configuration).
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.