lsarray

The lsarray command displays a list of arrays in a storage image and status information for each array in the list.


>>-lsarray -+--------------------------+--+-----+--------------->
            '- -dev-- storage_image_ID-'  +- -s-+   
                                          '- -l-'   

>--+---------------------------+-------------------------------->
   '- -state--+- assigned----+-'   
              +- unassigned--+     
              '- unavailable-'     

>--+---------------------------+--+---------------------+------->
   '- -data--+- normal-------+-'  '- -raidtype--+- 5--+-'   
             +- degraded-----+                  +- 6--+     
             +- readonly-----+                  '- 10-'     
             +- failed-------+                              
             +- repairing----+                              
             '- inaccessible-'                              

>--+----------------------+--+------------------+--------------->
   '- -dapair-- dapair_ID-'  '- -cap-- capacity-'   

>--+------------------+--+-----------------------------+-------->
   '- -rank-- rank_ID-'  '- -encrypt--+- supported---+-'   
                                      '- unsupported-'     

>--+--------------------------+--------------------------------><
   +- array_ID--+-----------+-+   
   |            '-  . . .  -' |   
   '- " - "-------------------'

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which includes the manufacturer, machine type, and serial number. The storage image ID is required if you do not specify a fully qualified array ID, do not set the devid variable in your profile or through the setenv command, and the HMC is aware of more than one storage image. Using the -dev parameter temporarily overrides any defined value for devid for the current command.

-s

(Optional) Displays only the array ID. You cannot use the -l and the -s parameters together.

-l

(Optional) Displays default output plus the disk class and encryption capability of the arrays. You cannot use the -l and the -s parameters together.

-state assigned | unassigned | unavailable

(Optional) Specifies that information about those arrays in the designated state are to be displayed on the generated report.

(Optional) Specifies that information about those arrays in the designated data state are to be displayed on the generated report.

-raidtype 5 | 6 | 10

(Optional) Displays only those arrays with the specified RAID type, 5, 6, or 10.

-dapair dapair_ID

(Optional) Displays only the array that is specified by the device adapter pair ID. A device adapter pair ID is a two-digit decimal number with no leading zeros.

-cap capacity

(Optional) Displays in decimal gigabytes (GB) only the array with the specified DDM capacity. You can specify up to three digits after the decimal point, for example -cap 1.447.

-rank rank_ID

(Optional) Displays only the array that is assigned to the specified rank ID. A rank ID is a four-digit decimal number with no leading zeros, prefixed with the letter R.

-encrypt supported | unsupported

(Optional) Displays only the array sites that have the specified encryption capability.

array_ID . . . | -

(Optional) Displays array information for the specified arrays. An array ID is a four-digit decimal number with no leading zeros, prefixed with the letter A.

To specify a range of array IDs, separate the array IDs with a hyphen. For example: A10-A12 (equates to A10 A11 A12)

You must separate multiple array IDs or ranges of array IDs with a blank space between each ID or range of IDs. For example: A11 A12 A14-A16. Your command in this case could look like:

For DS8000,

dscli> lsarray IBM.2107–75FA120 -l A11 A12 A14-A16

The ellipsis (...) indicates that, optionally, you can specify multiple values.

If you use the dash (-), the specified value is read from standard input. You cannot use the dash (-) while you are in the DS CLI interactive command mode.

Example

For this command and all other DS CLI list commands, the results are shown in table format to provide clarity. The actual reports do not display as tables.

The following tables represent the headers that are displayed on the output report that is associated with the lsarray command using the -l parameter.

Invoking the lsarray command

dscli> lsarray -dev IBM.2107–75FA120 -l

The resulting output

Array	State	Data	RaidType
A10	Assigned	Normal	5(6+p)
A11	Assigned	Normal	5(7+p)
A12	Assigned	Normal	5(6+p)
A13	Unassigned	Normal	5(7+p)

Arsite	Rank	DA Pair	DDMcap (10^9B)	Diskclass	Encrypt
S20	R11	10	145	ENT	supported
S21	R12	11	145	ENT	supported
S30	R13	20	300	NL	unsupported
S31	-	21	300	SATA	unsupported

Report field descriptions

Array^*

Indicates the array number. The array number starts with the prefix A, followed by a decimal number up to four digits in length, with no leading zeros. For example, A44.

State

Indicates the relationship between the array and a rank. One of the following values is displayed:

Assigned: The array is assigned to a rank.
Unassigned: The array is not assigned to a rank and all of the storage devices that are indicated by the disk serial numbers attribute are in the normal state.
Unavailable: The array is not assigned to a rank and one or more of the disk drive modules (DDMs) that are indicated by the disk serial numbers attribute are not in the normal state.

Data

This value reflects the current data status. One of the following values is displayed:

Normal

The array is in the Normal data state if none of the other data states applies. This status applies if the array is unassigned.

Degraded

The array is in the Degraded data state if both of the following conditions exist:

The Read-only, Failed, Repairing, or Inaccessible data states do not apply.
One or more redundancy groups are rebuilding (that is, there is a DDM with a rebuilding state in the array).

Read Only

The array is in the Read-only data state if all of the following conditions exist:

The Failed, Repairing, and Inaccessible data states do not apply.
One or more DDMs have failed.
There are insufficient spares to support all rebuild operations.
Continued write operation without redundancy could result in data loss.

Failed

The array is in the Failed data state if all of the following conditions exist:

The Repairing and Inaccessible data states do not apply.
Two or more DDMs in the array have failed.
There are insufficient DDMs left in the array to rebuild the data that was lost on the failing storage devices.

Repairing

The array is in the Repairing data state if all of the following conditions exist:

The Inaccessible data status does not apply.
The array has previously entered the failed state.
The repair array function has been accepted.
The repair array function has not completed.

Inaccessible

The array is in the Inaccessible data state if the storage unit cannot access a set of storage devices that are sufficient to access all the data on the array.

RaidType

Indicates the type of RAID array (5, 6, or 10) and the array configuration (for example, 6+P). DS8000® array configurations are based on 8 DDM array sites for DA Pair Types 1 and 2, and 7 or 8 DDM array sites for DA Pair Type 3.

Arsite

Indicates the array sites that are associated with the array.

Rank

Indicates the rank the array is assigned to. The value is displayed as a combination of a Storage Image ID and a rank number. The rank number is the prefix R, followed by a decimal number up to four digits in length, with no leading zeros. For example, R26.

DA pair

Identifies the DA pair ID. DA pairs are located in I/O enclosure pairs. DA pair ID indicates the I/O enclosure location.

Note: An even-numbered DA pair ID indicates the first DA pair in an I/O enclosure pair. An odd-numbered DA pair ID indicates the second DA pair in an I/O enclosure pair.

DDMcap (10^9B)

Indicates the minimum disk capacity in decimal gigabytes (GB) of the storage devices (DDMs) in the specified array.

Diskclass⁺

Indicates the disk class. One of the following values is displayed:

ENT: Indicates enterprise and represents high speed Fibre Channel disk drives
Flash: Indicates high-performance flash devices.
NL: Indicates near-line and represents ATA (FATA) disk drives
SATA: Indicates high capacity SATA disk drives.
SSD: Indicates solid-state devices.

encrypt

Indicates the encryption support capability. One of the following values is displayed:

supported: The disk drive modules in this array are encryption capable.
unsupported: The disk drive modules in this array are not encryption capable.

Key:

*: Displayed when the -s parameter is specified.
+: Displayed only when the -l parameter is specified.