lsarray

Use the lsarray command to list the array MDisks.

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.

-bytes

(Optional) Requests output of capacities in bytes (instead of rounded values).

-filtervalue capacity=value

(Optional) Specifies a list of one or more filter capacities (size) values matching the specified values for the unit parameter. Use the unit parameter to interpret the value for size or capacity.

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

(Optional) The units that are used when you specify the -filtervalue capacity, where:

b = bytes
kb = 1,024 bytes
mb = 1,048,576 bytes
gb = 1,073,741,824 bytes
tb = 1,099,511,627,776 bytes
pb = 1,125,899,906,842,624 bytes

mdisk_id

(Optional) The identity of the array MDisk.

mdisk_name

(Optional) The name of the array MDisk.

Description

This command returns a concise list or a detailed view of array MDisks visible to the system. This table provides the attribute values that can be displayed as output view data.

Table 1. Array output
Attribute	Values
capacity	Indicates the value for the capacity you specify by using the -unit parameter.
status	Indicates the array status. The values are: online offline excluded degraded (applies only to internal MDisks)
mode	Indicates the mode. The values are: `unmanaged` `managed` `image` `array`
quorum_index	Indicates the quorum index. The values are: `0` `1` `2` Blank if the MDisk is not being used as a quorum disk.
block_size	Indicates the block size. The value is `512` bytes (or blank) in each block of storage.
ctrl_type	`4`, `6`, where `6` is a flash drive attached inside a node and 4 is any other device.
raid_status	Indicates the RAID status. The values are: offline The array is offline on all nodes. degraded The array has deconfigured or offline members; the array is not fully redundant. syncing The array members are all online. The array is synchronizing parity or mirrors to achieve redundancy. initializing The array members are all online. The array is initializing; the array is fully redundant. online The array members are all online and the array is fully redundant. expanding The array members are all online and the array is expanding.
fast_write_state	Indicates the cache state of the array. The values are: `empty`, which indicates that the array disk data is not changing. `not_empty`, which indicates that the array disk data might change. `corrupt`, which indicates that the array disk data is lost and the array is corrupt. Repair can be initiated by using the recoverarray or recoverarraybysystem command.
raid_level	Indicates the RAID level of the array. The values are: `raid0` `raid1` `raid5` `raid6` `raid10`
raid_level	Indicates the RAID level of the array.
redundancy	Indicates the number of member disks that can fail concurrently without causing the array to fail.
rebuild_ahead	Indicates the `rebuild_ahead` specification: `off` indicates that the array cannot rebuild ahead. `minimum` indicates that the array can rebuild ahead of a limited number of RAID stripes. `medium` indicates that the array can rebuild ahead of a moderate number of RAID stripes. `maximum` indicates that the array can rebuild ahead of many RAID stripes.
rebuild_priority	Indicates the rebuild priority: `hostmax` indicates that the maximum priority is given to the host operations to minimize the impact of the rebuild operation. `hostweighted` indicates that host I/O operations are given higher priority than rebuild operations. `rebuildweighted` indicates that rebuild operations are given higher priority than host I/O operations. `rebuildmax` indicates that maximum priority is given to the rebuild operations (over host I/O operations).
enclosure_id	Indicates which enclosure the array belongs to.
scrub_rate	Indicates the speed of the background array sweeper. The value must be a number in the range `0` - `100`: `0` turns off the sweeper. `100` consumes the most bandwidth.
scrub_progress	Indicates the progress (percentage) of the background array sweeper. The value is reset to `0` after it reaches `100`, and another sweep begins.
flashsystem	Indicates the type of array for this system. The values are `yes` and `no`.
strip_size	Indicates 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	For distributed arrays, this value indicates whether a superior drive class is being used for the array: `exact` indicates that the same drive class is in use. `yes` indicates that at least one array member exceeds the array drive class. For distributed arrays, the array must also be balanced to its rebuild area goals.
tier	Indicates the tier that this array is assigned to by auto-detection (for internal arrays) or by the user: `tier0_flash` `tier1_flash` `tier_enterprise` `tier_nearline` `tier_scm` Note: Use the chmdisk command to change this value.
replacement_date	Indicates the date of a potential array failure. The format must be `YYMMDD`.
easy_tier_load	Indicates the value for Easy Tier® settings, and is either blank (for arrays) or one of the following values (for MDisks): `low` `medium` `high` `very_high`
slow_write_priority	Indicates the response time goal: `latency` indicates that the array is taken out of synchronization to quickly complete write operations that take excessive time. `redundancy` indicates slow write operations are completed in normal time and the arrays remain synchronized.
site_id	Indicates the site value for the storage pool. This numeric value is `1`, `2`, `3`, or blank.
site_name	Indicates the site name for the storage pool. This value is alphanumeric or is blank.
fabric_type	Indicates a Fibre Channel (FC), SAS, or another type of array. `fc` indicates an array from an FC controller. `sas_direct` indicates an array from an SAS direct-attached controller.
encrypt	Indicates whether the data that is stored on the array is encrypted or not encrypted. The possible values are: `yes` `no`
distributed (Deprecated)	Indicates whether the array is distributed. The value of this attribute is always `yes`.
dedupe (Deprecated)	Indicates whether the backend mdisk is deduplicated and it is applicable to FlashSystem A9000 only. For details, see lsmdisk.
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 nondistributed arrays.
drive_count	Indicates the total width of the array, including rebuild areas. The value is a number in the range 2 - 128. The minimum value for RAID-6 and RAID-10 arrays is 6. The minimum value for distributed RAID-1 is 2.
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. An even number in the range `2` - `16` for distributed RAID-1 arrays.
rebuild_areas_total	Indicates the total number of rebuild areas set when the array is created. These rebuild areas provide performance but no capacity. The value is from `1` - `4` for distributed array RAID-5 and distributed array RAID-6. The value is from `0` - `1` for distributed RAID-1. The value is blank for nondistributed arrays.
rebuild_areas_available	Indicates the number of remaining rebuild areas within the set of drives. The value is `1` - `4` for distributed array RAID-5 and distributed array RAID-6. The value is from `0` - `1` for distributed RAID-1. The value is blank for nondistributed arrays.
rebuild_areas_goal	Indicates the rebuild areas threshold (minimum limit) at which point the array logs an error. The value is `1` - `4` for distributed array RAID-5 and distributed array RAID-6. The value is blank for nondistributed arrays.
over_provisioned	Shows `yes` if the MDisk is thin-provisioned. Shows `no` if the disk is marked as standard-provisioned, resource-provisioned, or the information cannot be determined.
supports_unmap	Shows `yes` if the MDisk indicates UNMAP support. Shows `no` if the disk indicates it does not support UNMAP, or the information cannot be identified.
provisioning_group_id	System allocated identifier of the provisioning group that relates to the MDisk. This identifier is used to identify the list of MDisks that are provided by the same provisioning group.
physical_capacity	The total physical storage capacity of the provisioning group providing this MDisk. If this disk is not `over_provisioned`, then logical capacity is reported here.
physical_free_capacity	The amount of formatted available physical space in the provisioning group providing this MDisk. If this disk is not `over_provisioned`, then remaining logical capacity is reported here.
write_protected	Shows `yes` if the array is in the write protected state, otherwise `no`.
data_reduced	Indicates that the MDisk data is reduced. The values are `yes` or `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 array for volume data and quorum.
fips	Indicates if the array is FIPs only mode for drives. The values are `yes` and `no`.
deduplicated	Indicates if all drives in the array support deduplication.
anomaly_detection_active	Indicates if an array participated in a recent aggregation of anomaly statistics. The values are `yes`, `no`, and `partial`.

This list defines 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.