lsarray

Use the lsarray command to list the array MDisks.

Syntax

lsarray [ -nohdr ] [ -delimdelimiter ] [ -bytes ] [ -filtervalue? ] { [ -filtervalue attribute=value ] | [ -filtervaluecapacity=value -unit { b | kb | mb | gb | tb | pb } ] } [ { mdisk_id | mdisk_name } ]

Parameters

-nohdr

(Optional) By default, headings are displayed 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.

-delim delimiter

(Optional) 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. In a detailed view, the data is separated from its header by the specified delimiter.

-bytes

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

-filtervalue?

(Optional) Includes all of the valid filter attributes in the report. The following filter attributes are valid for the lsarray command:

balanced

capacity

distributed

mdisk_id

mdisk_name

mode

mdisk_grp_id

mdisk_grp_name

fast_write_state

raid_status

raid_level

redundancy

spare_goal

spare_protection_min

status

strip_size

tier

easy_tier_load

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

-filtervalueattribute=value

(Optional) Specifies a list of one or more filter attributes matching 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 entering the command. The following rules apply to the use of wildcards when using the 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 using a wildcard character, you must enclose the filter entry within double quotation marks (""):
lsarray -filtervalue "name=md*"

-filtervaluecapacity=value

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

-unitb | kb | mb | gb | tb | pb

(Optional) The units that are used when applying 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 clustered system (system). Table 1 provides the attribute values that can be displayed as output view data.
Table 1. Array output

Attribute Values

capacity The value for the capacity specified when using the -unit parameter.

status

online

offline

excluded

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

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.

raid_level The RAID level of the array (RAID0, RAID1, RAID5, RAID6, RAID10).

redundancy The number of member disks that can fail concurrently without causing the array to fail.

strip_size The strip size of the array (in KB).

spare_goal The number of spares that the array members should be protected by. For distributed arrays, this value is blank.

spare_protection_min The minimum number of spares that an array member is protected by. For distributed arrays, this value is blank.

balanced
For nondistributed arrays, this describes if the array is balanced to its spare goals:

exact indicates that all populated members have the same (matching) capability and location.

yes indicates that all populated members have at least the same capability and chain, but a different enclosure or slot.

no indicates that it is unbalanced.

For distributed arrays, this 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:

ssd

nearline

enterprise (the default value for newly discovered or external MDisk)

Note: Use the chmdisk command to change this value.

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

slow_write_priority Describes 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 stored on the array is encrypted or not encrypted. The possible values are:

yes

no

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 nondistributed arrays.

drive_count Indicates the total width of the array, including rebuild areas. The value is a number from 4 to 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 from 3 - 16 for RAID-5 arrays

Any number from 4 - 16 for RAID-6 arrays

An even number from 2 - 16 for RAID-10 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 1 - 4 for distributed array RAID-5 and distributed array RAID-6. 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 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.

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 have been 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
lsarray -delim :

The resulting output:

mdisk_id:mdisk_name:status:mdisk_grp_id:mdisk_grp_name:capacity:raid_status:raid_level:redundancy:strip_size:tier:encrypt:distributed 1::online:0:mdiskgrp0:68.4GB:online:raid0:0:256:enterprise:no:yes 2:mdisk2:online:0:mdiskgrp0:88.4GB:syncing:raid5:1:256:nearline:no:no 533:mdisk533:degraded:1:mdiskgrp1:78.2GB:syncing:raid6:2:128:ssd:yes:yes 534:mdisk534:online:2:mdiskgrp1:94.2GB:initting:raid6:2:64:ssd:yes:no

A detailed invocation example
lsarray

The resulting output:

mdisk_id 144 mdisk_name draid6_5 status online mode array mdisk_grp_id 1 mdisk_grp_name pool_512 capacity 5.6TB quorum_index block_size controller_name ctrl_type ctrl_WWNN controller_id path_count max_path_count ctrl_LUN_# UID preferred_WWPN active_WWPN fast_write_state not_empty raid_status initting raid_level raid6 redundancy 2 strip_size 256 spare_goal spare_protection_min balanced exact tier enterprise slow_write_priority redundancy fabric_type site_id site_name easy_tier_load encrypt no distributed yes drive_class_id 1 drive_count 28 stripe_width 15 rebuild_areas_total 4 rebuild_areas_available 4 rebuild_areas_goal 2

A detailed invocation example
lsarray 1

The resulting output:

mdisk_id:1 mdisk_name: status:online mode:array mdisk_grp_id:0 mdisk_grp_name:mdiskgrp0 capacity:68.4GB quorum_index: block_size: controller_name: ctrl_type: ctrl_WWNN: controller_id: path_count: max_path_count: ctrl_LUN_#: UID: preferred_WWPN: active_WWPN: node_id: node_name: location: fast_write_state:empty raid_status:online raid_level:raid0 redundancy:0 strip_size:256 spare_goal:2 spare_protection_min:2 balanced:yes tier:ssdeasy_tier_load:mediumslow_write_priority:latencyfabric_type:encrypt:yesdistributed no drive_class_id drive_count 8 stripe_width 4 total_rebuild_areas available_rebuild_areas rebuild_areas_goal

Attribute	Values
capacity	The value for the capacity specified when using the -unit parameter.
status	online offline excluded degraded (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 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	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.
raid_level	The RAID level of the array (`RAID0`, `RAID1`, `RAID5`, `RAID6`, `RAID10`).
redundancy	The number of member disks that can fail concurrently without causing the array to fail.
strip_size	The strip size of the array (in KB).
spare_goal	The number of spares that the array members should be protected by. For distributed arrays, this value is blank.
spare_protection_min	The minimum number of spares that an array member is protected by. For distributed arrays, this value is blank.
balanced	For nondistributed arrays, this describes if the array is balanced to its spare goals: `exact` indicates that all populated members have the same (matching) capability and location. `yes` indicates that all populated members have at least the same capability and chain, but a different enclosure or slot. `no` indicates that it is unbalanced. For distributed arrays, this 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: `ssd` `nearline` `enterprise` (the default value for newly discovered or external MDisk) Note: Use the chmdisk command to change this value.
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`
slow_write_priority	Describes 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 stored on the array is encrypted or not encrypted. The possible values are: `yes` `no`
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 nondistributed arrays.
drive_count	Indicates the total width of the array, including rebuild areas. The value is a number from `4` to `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 from `3` - `16` for RAID-5 arrays Any number from `4` - `16` for RAID-6 arrays An even number from `2` - `16` for RAID-10 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 `1` - `4` for distributed array RAID-5 and distributed array RAID-6. 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 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.