lsdrive

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

Syntax

Read syntax diagramSkip visual syntax diagram lsdrive -bytesdrive_id

Parameters

-delim delimiter
(Optional) Specify a delimiter to separate data in the output.
-nohdr
(Optional) Suppress the headings in the output.
-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.
-filtervalue?
(Optional) Displays a list of valid filter attributes.
-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.
Note: A backup of system state is stored on quorum disks, which contributes to the physically used space. The amount of data that is used for this backup depends on the system configuration, but is typically a few MB and cannot exceed 1 GB.
This table describes possible outputs.
Table 1. lsdrive output
Attribute Value
id Indicates the ID of the drive.
status Indicates the summary status 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.
error_sequence_number Indicates the error sequence number that describes 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 value 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 is not configured to be used by anything.
  • candidate if the drive is available to be configured.
  • member if the drive is configured as a member of an array.
  • failed if the drive is rejected and is no longer available for use.
UID Indicates that 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).
  • tier_scm
  • tier0_flash
  • tier1_flash
  • tier_enterprise
  • tier_nearline
replacement_date Indicates the date of a potential drive failure. The format must be YYMMDD. This value is blank for non-SSD drives.
capacity Indicates the capacity of the disk, excluding quorum area.

For compressed drives, this output represents the logical capacity of the drive, which is greater than the physical capacity, and is determined by the number of addressable logical blocks that are presented by the drive.

For non-compressed drives, the capacity value is the same for both logical and physical capacity.

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 that combines 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 whether the:
  • Drive is contained in an enclosure (not a node) and the slot position is known. This value is the ID of the enclosure in which the drive is located.
  • Drive is contained in a node (not an enclosure). This value is blank.
  • Enclosure ID is not determined yet. This value 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 value can be blank.
node_name Indicates the node name where the drive is located for a drive that is 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 that is contained within a node. For a drive contained within an enclosure, the value is blank.
quorum_id Indicates the ID of quorum disk. The value is 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 that ends 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 that ends in -2.
health_state Indicates the drive health status:
  • good indicates good health.
  • warning indicates a warning that must be examined.
  • critical indicates something critical that must be addressed.
  • unknown indicates that the status is unknown.
encrypted Indicates the state of the drive encryption.
rekey Indicates the state of the rekey of each drive:
  • committing indicates that the rekey is being committed.
  • prepared indicates that the rekey is being prepared.
  • error indicates that there is an error with the rekey.
  • blank indicates that there is no status.
auto_manage Indicates whether 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 that is 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:
  1. Not SSDs.
  2. SSDs that predate support of the endurance indicator.
This value 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 value is blank for non-SSD drives.
Note: This field displays a value only when the write_endurance_used value changes.
date_of_manufacture Indicates the manufacture date for SAS drives (YYMMDD).
fips_enabled Indicates if the drive follows FIPS standards. Value can be yes or no.
patch_firmware Indicates the firmware version included in the drive firmware patch.
flash_core_module Indicates if the drive is an FCM.
deduplicated Indicates if the drive supports deduplication.