lsdrive

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

Syntax

lsdrive [ -filtervalue attribute_value ] [ -nohdr ] [ -delim delimiter ] [ -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*"

-nohdr

(Optional) By default, headings are displayed for each column of data in a concise style view, and 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) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum possible width of each item of data. 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 one-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.

-filtervalue?

(Optional) Displays the valid filter attributes for the -filtervalue parameter:

capacity
enclosure_id
error_sequence_number
id
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`, which is blank `degraded`, which is populated if associated with an error `offline`, which 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. The values are: `unsupported` indicates that the drive is not supported in this platform (contact your support team). tier0_flash tier1_flash tier_enterprise tier_nearline `drive.flashcard` indicates the flash drive.
replacement_date	Indicates the date of a potential drive failure. The format must be `YYMMDD`. This is blank for non-SSD drives.
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`.
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.
write_endurance_used	Indicates the drive writes per day (DWPD). This value is blank for drives that are not SSD drives. The value must be a number 0 - 255. This value indicates the percentage of life used by the drive. The value `0` indicates that full life remains, and `100` indicates that the drive is at or past its end of life. Note: The drive must be replaced when the value exceeds `100`. This value is blank for drives that are either: Not SSDs. SSDs that predate support of the endurance indicator. This also applies to drives that are yet to be polled, which can take up to 24 hours.
write_endurance_usage_rate	Indicates the DWPD usage rate. The values are: `measuring` `high` `marginal` `low` This is blank for non-SSD drives.

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:tier0_flash:20GB:0:mdisk0:0:1:2:active:0
1:offline:345:member:tier0_flash:20GB:0:mdisk0:0:1:3:idle:0
2:online::member:tier0_flash:20GB:0:mdisk0:0:1:4:active:0

A detailed invocation example for an SSD drive

lsdrive 0

The detailed resulting output:

id:0
status:online
error_sequence_number:
use:member
UID:20000004cf4cd2c0
tech_type:tier0_flash
capacity:20GB 
block_size:512
vendor_id:IBM
product_id:I8MR1337 W00Y4Y1
FRU_part_number:AAAAAAA
FRU_identity:11S1817115Y41337171001
RPM:
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
auto_manage:activedrive_class_id:3write_endurance_used:5write_endurance_usage_rate:highwork_load:highreplacement_date:190806

A detailed invocation example for a tier 1 flash SSD drive

lsdrive 0

The detailed resulting output:

id 0
status degraded
error_sequence_number
use candidate
UID 5000c5002624a723
tech_type sas_hdd
capacity 1.8TB
block_size 512
vendor_id IBM-207x
product_id ST32000444SS
FRU_part_number 85Y5869
FRU_identity 11S41Y8471YXXX9WM40LMD
RPM 10000
firmware_level BC2D
FPGA_level
mdisk_id
mdisk_name
member_id
enclosure_id 1
slot_id 7
node_id
node_name
quorum_id 0
port_1_status online
port_2_status offline
interface_speed 6Gb
protection_enabled no
auto_manage inactive
drive_class_id 3
write_endurance_used 30
drive_class_idwrite_endurance_used 5write_endurance_usage_rate highwork_load highreplacement_date 190806

A detailed invocation example for a hard disk drive (HDD)

lsdrive 0

The detailed resulting output:

id 0
status degraded
error_sequence_number
use candidate
UID 5000c5002624a723
tech_type sas_nearline_hdd
capacity 1.8TB
block_size 512
vendor_id IBM-207x
product_id ST32000444SS
FRU_part_number 85Y5869
FRU_identity 11S41Y8471YXXX9WM40LMD
RPM 7200
firmware_level BC2D
FPGA_level
mdisk_id
mdisk_name
member_id
enclosure_id 1
slot_id 7
node_id
node_name
quorum_id 0
port_1_status online
port_2_status offline
interface_speed 6Gb
protection_enabled no
auto_manage inactive
drive_class_id 3
write_endurance_used 
drive_class_idwrite_endurance_used 5write_endurance_usage_rate highwork_load highreplacement_date 190806