lsarray

Use the lsarray command to list the array MDisks.

Syntax

Read syntax diagramSkip visual syntax diagram lsarray -nohdr-delimdelimiter-bytes-filtervalue?-filtervalueattribute=value-filtervaluecapacity=value-unitbkbmbgbtbpbmdisk_idmdisk_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 1-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:Any parameters that are specified with the -filtervalue? parameter are ignored.
-filtervalue attribute=value
(Optional) Specifies a list of one or more filter attributes 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 when you use 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 you use a wildcard character, you must enclose the filter entry within double quotation marks (""):
    lsarray -filtervalue  "name=md*"
-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
block_size Indicates the block size. The value is 512 bytes (or blank) in each block of storage.
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.
redundancy Indicates the number of member disks that can fail concurrently without causing the array to fail.
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.
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
degraded_paths
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.