lsdrive

Use the lsdrive command to display configuration information and drive vital product data (VPD).

Syntax

lsdrive [ -filtervalueattribute_value ] [ -filtervalue? ] [ -bytes ] [ drive_id ]

Parameters

-filtervalueattribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed.
Note: Some filters allow the use of a wildcard when you enter the command. The following rules apply to the use of wildcards:
  • The wildcard character is the asterisk (*).
  • The command can contain a maximum of one wildcard.
  • When you use a wildcard, enclose the filter entry within double quotation marks (""): lsdrive -filtervalue mdisk_id="1*"
-filtervalue?
(Optional) Displays the valid filter attributes for the -filtervalue parameter:
  • capacity
  • enclosure_id
  • error_sequence_number
  • id
  • interface_speed
  • mdisk_id
  • mdisk_name
  • member_id
  • node_id
  • node_name
  • slot_id
  • status
  • tech_type
  • use
  • drive_class_id
-bytes
(Optional) The size (capacity) of the drive in bytes.
drive_id
(Optional) The identity of the drive.

Description

Use this command to display configuration information and drive VPD.
Note: Filtering should be permitted on all concise fields.
Table 1 describes possible outputs.
Table 1. lsdrive output
Attribute Value
id Indicates the ID of the drive:
  • online, which indicates that the drive is available through all drive ports
  • degraded, which indicates that the drive is available but not through all drive ports
  • offline, which indicates that the drive is unavailable
status Indicates the summary status of the drive.
error_sequence_number Indicates the error sequence number describing the cause of the drive status:
  • online: blank
  • degraded: populated if associated with an error
  • offline: must be populated
Note: Error sequence numbers indicate an entry in the event log. This includes entries that are both errors, and informational messages (for example, the drive is formatting).
use Indicates the current role of the drive:
  • unused if the drive which is not configured to be used by anything
  • candidate if the drive is available to be configured
  • spare if the drive is configured as a spare, to be used if the arrays fail members
  • member if the drive is configured as a member of an array
  • failed if the drive has been rejected and is no longer available for use
UID Indicates the unique ID reported by the drive.
tech_type Indicates the drive technology used.
capacity Indicates the capacity of disk, excluding quorum area.
block_size Indicates the block size of the disk.
vendor_id Indicates the manufacturer of the drive.
product_id Indicates the product ID of the drive.
FRU_part_number Indicates the FRU part number of the drive.
FRU_identity Indicates the 11S number combining manufacturing part number and serial number.
RPM Indicates the specified RPM of the disk.
firmware_level Indicates the firmware level of the disk; blank if unknown.
FPGA_level Indicates the FPGA level, if applicable; blank if not applicable or unknown.
mdisk_id Indicates the ID of the array MDisk that the drive is a member of.
mdisk_name Indicates the name of the MDisk that the drive is a member of.
member_id Indicates the ID of the MDisk array member.
enclosure_id Indicates if the:
  • Drive is contained in an enclosure (not a node) and the slot position is known, this is the ID of the enclosure in which the drive is located.
  • Drive is contained in a node (not an enclosure), this is blank.
  • Enclosure ID has not been determined yet, this is blank.
slot_id Indicates the slot_id of the drive in the enclosure or node. It can be referred to as the drive bay or location. This can be blank.
node_name Indicates the node name where the drive is located for a drive contained within a node. For a drive contained within an enclosure, it is blank.
node_id Indicates the node ID where the drive is located for a drive contained within a node. For a drive contained within an enclosure, blank.
quorum_id Indicates the ID of quorum disk; blank if not quorum disk.
port_1_status Indicates the connectivity status of the drive's first port. The values are online, offline, or excluded.
Note: Port 1 is attached to the node that has a panel name ending in -1.
port_2_status Indicates the connectivity status of the drive's second port. The values are online, offline, or excluded.
Note: Port 2 is attached to the node that has a panel name ending in -2.
interface_speed Indicates the lowest interface speed for the connected drive slot (in gigabits per second, or Gbps). The values are:
  • 1.5 Gbps
  • 3 Gbps
  • 6 Gbps
  • 12 Gbps
  • Blank if both ports are isolated or the drive is not connected
protection_enabled Indicates if SCSI type-2 protection information is enabled (yes) or not (no).
auto_manage Indicates if the auto_manage process is running (active) or not running (idle).
drive_class_id Indicates which drive class the drive is part of.

A concise invocation example

lsdrive -delim :

The concise resulting output:

id:status:error_sequence_number:use:tech_type:capacity:mdisk_id:mdisk_name:member_id:enclosure_id:slot_id:auto_manage:drive_class_id
0:online::member:sas_ssd:20GB:0:mdisk0:0:1:2:active:0
1:offline:345:member:sas_ssd:20GB:0:mdisk0:0:1:3:idle:0
2:online::member:sas_ssd:20GB:0:mdisk0:0:1:4:active:0

A detailed invocation example

lsdrive 0

The detailed resulting output:

id:0
status:online
error_sequence_number:
use:member
UID:20000004cf4cd2c0
tech_type:ssd
capacity:20GB 
block_size:512
vendor_id:IBM
product_id:I8MR1337 W00Y4Y1
FRU_part_number:AAAAAAA
FRU_identity:11S1817115Y41337171001
RPM:15000
firmware_level:3.02

FPGA_level:1.99
mdisk_id:0
mdisk_name:mdisk0
member_id:0
enclosure_id:1
slot:2
node_id:
node_name:
quorum_id:
port_1_status:online
port_2_status:online
interface_speed:6Gbprotection_enabled:yesauto_manage:activedrive_class_id:3
Parent topic: Drive commands