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
- -filtervalue attribute=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.
Attribute | Value |
---|---|
id | Indicates the ID of the drive:
|
status | Indicates the summary status of the drive. |
error_sequence_number | Indicates the error sequence number describing the cause of the drive status:
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:
|
UID | Indicates the unique ID reported by the drive. |
tech_type | Indicates the drive technology used. The values are:
|
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:
|
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:
|
write_endurance_usage_rate | Indicates the DWPD usage rate. The values are:
|
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_hdd:20GB:0:mdisk0:0:1:2:active:0
1:offline:345:member:sas_hdd:20GB:0:mdisk0:0:1:3:idle:0
2:online::member:sas_hdd: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:ssd
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:active
drive_class_id:3
write_endurance_used:5
write_endurance_usage_rate:high
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_id
write_endurance_used 5
write_endurance_usage_rate high
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_id
write_endurance_used 5
write_endurance_usage_rate high