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----+-'  '- -data--+-normal-------+-'   
              +-unassigned--+              +-degraded-----+     
              '-unavailable-'              +-readonly-----+     
                                           +-failed-------+     
                                           +-repairing----+     
                                           '-inaccessible-'     

>--+--------------------+--+---------------------+-------------->
   '- -raidtype--+-5--+-'  '- -dapair--dapair_ID-'   
                 '-10-'                              

>--+-----------------+--+-----------------+--------------------->
   '- -cap--capacity-'  '- -rank--rank_ID-'   

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

Parameters

-dev storage_image_ID

(Optional) Specifies the storage image ID, which includes the manufacturer, machine type, and serial number. This parameter is required if the fully qualified array ID is not specified.

-s

(Optional) Specifies that only the array ID information be displayed on the generated report. You cannot use the -l and the -s parameters together.

-l

(Optional) Specifies that all information about the array including the array ID be displayed on the generated report. You cannot use the -l and the -s parameters together.

-state assigned | unassigned | unavailable

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

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

-raidtype 5 | 10

(Optional) Displays only those arrays with the specified RAID type, 5 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 gigabytes (GB) only the array with the specified DDM capacity. You can specify up to three digits after the decimal point, for example -cap 144.7.

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

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:

dscli>lsarray IBM.1750–68FA120 -l A11 A12 A14-A16

If you specify the dash (-), this parameter information is automatically supplied. 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. A separate example is not shown for the 1750 because the information is the same for both the 2107 and 1750.

Invoking the lsarray command

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

The resulting output

Sun Aug 11 02:23:49 PST 2004 IBM DS CLI Version: 5.0.0.0 DS: IBM.2107–75FA120

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
S20	R11	10	145	ENT
S21	R12	11	145	ENT
S30	R13	20	300	NL
S31	-	21	300	NL

Report field descriptions

Array

Specifies the array number. The array number starts with the prefix A, followed by a four-digit decimal number with no leading zeros (for example, A44).

State

Specifies 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 or 10) and the array configuration (for example, 6+P).

arsite

Indicates the array sites that are associated with the array.

Rank

Specifies 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 four-digit decimal number, 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^9 Byte)

Indicates the minimum disk capacity (10^9 Byte) of the storage devices (DDMs) in the specified array.

Disk class

Specifies the disk class as either high speed fibre-channel disk drives or near-line disk drives. The displayed value is one of the following:

ENT: Specifies enterprise and represents high speed fibre-channel disk drives
NL: Specifies near-line and represents ATA (FATA) disk drives