lsarray
Use the lsarray command to display
information about arrays and back-end storage systems. For SAN Volume Controller, XIV® systems, and Dell EMC VMAX and VNX storage systems, the command displays
information about block pools.You use the setarray command or
autosetarray command to provide information about back-end storage systems. You
can also enter information about back-end storage systems on the Pool
Properties page in the IBM Spectrum Control™ GUI.
Syntax
Parameters and arguments
- -user user_name
- Specifies an IBM Spectrum Control™ user ID.
- -pwd password
- Specifies the password for the IBM Spectrum Control user ID.
- -url url
- Specifies the Device server. The format of the URL is system:port_number, where system represents either the host name or IP address, and port_number represents the IBM Spectrum Control Device server port.
- -dev system
- Specifies the globally unique identifier (GUID) of the storage system. You can use the lsdev command to return information, including the GUID, for all storage systems that are discovered by IBM Spectrum Control.
- -l
- Specifies that the detailed version of information about arrays is provided. If you issue the
lsarray command and do not specify the -l parameter, only
the array ID is displayed.
Column label Details Array The ID of the array. Label The name of the storage pool (managed disk group). Total Size (GB) The total amount of storage space. Free Size (GB) The total amount of available storage space. Status The operational status of the storage pool that hosts the array. Types of Disk The types of disk that host the arrays. - Solid State for solid-state disks
- Non-Solid State for hard disks
- Mixed for solid-state disks and hard disks
Encrypted Shows whether arrays are hosted on encrypted disks. Read I/O Capability Shows the read I/O capability in seconds of storage arrays. The calculation of read I/O capability is based on the following characteristics. - The type of storage system
- The type of RAID
- The type of disk
- The number of disks
Back-end Type The type of back-end storage system that manages disk group storage. Back-end RAID Type The type of Redundant Array of Independent Disk (RAID) that the back-end storage system uses. Back-end Disk Type The type of disk that the back-end storage system uses. Back-end Disk Count The total number of disks. Tip: To find out how to set values for back-end storage subsystems, see the description of the setarray command. - -fs character
- Specifies the 7-bit character that separates the information in the output. If you omit this parameter, the information is separated by blank spaces.
- -header
- Suppresses the column headings in the output. If you omit this parameter, the column headings are included.
- -help | -h | -?
- Lists help information for the command.
- -qs character
- Specifies the 7-bit character that surrounds character strings and date stamps in the output. If you omit this parameter, character strings and date stamps are enclosed by double quotation marks (").
- -silent
- Suppresses all output for the command. If you omit this parameter, output is included.
- -grouping
- Enables the grouping of numeric values. For example, in English the value 12000 would display as 12,000. The grouping character is determined by the system locale.
Example: Listing array information
The following command lists IDs for the arrays on the specified system:
tpctool> lsarray -user me -pwd mypass -url myhost:9550 -dev 2107.75DG000+0
The following output is returned:
Array
===========================================
IBMTSDS:IBM.2107-75DG000-P17+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P16+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P15+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P14+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P1+2107.75DG000+0
IBMTSDS:IBM.2107-75DG000-P0+2107.75DG000+0
Example: Listing detailed information about an array
The following command provides detailed information about the array on the specified system:
tpctool> lsarray -dev 0000020064405BA0+0 -l
The following output is returned:
Array Label Total Size (GB) Free Size (GB) ============================================================================== 0000020064405BA0:0+0000020064405BA0+0 mdisk_grp 407.38 310.25 Status Types of Disk Encrypted Read I/O Capability Back-end Type ============================================================================= NORMAL Non-Solid State No 0 D Back-end RAID Type Back-end Disk Type Back-end Disk Count =========================================================== 5 F10 160