SCSI Error Codes Solution Finder

Solution Unverified - Updated

Environment

  • Red Hat Enterprise Linux (RHEL) 7
  • Red Hat Enterprise Linux (RHEL) 6
  • Red Hat Enterprise Linux (RHEL) 5
  • Red Hat Enterprise Linux (RHEL) 4

Issue

  • /var/log/messages file contains one or more examples of;

    kernel: sd X:X:X:X: SCSI error: return code = 0xYYYYYYYY

    Or

    sd X:X:X:X: [sdZ] Result: hostbyte=DID_OK driverbyte=DRIVER_SENSE

    Where:

    • X:X:X:X: is a device address
    • 0xYYYYYYYY is a hexadecimal error code
    • Z is a device identifier

Resolution

Completing Diagnosis


You can use our automated [SCSI Error & Sense Key Decoder](https://access.redhat.com/labs/scsi/) to find the best solution to your error, or complete the Diagnostic Steps below and follow the links in this section

Error Codes and Sense Keys


Return Code 0x08000002


Sense Keys

Return Code 0x08070002


Sense Keys

Learn More


SCSI Error Codes Deep Dive


We have many Solutions explaining SCSI Error Codes that are specific to a combination of Return Code, Sense Key and Hardware. We also have an Article that covers SCSI Error codes in depth titled: [How do I interpret SCSI status messages in RHEL like "sd 2:0:0:243: SCSI error: return code = 0x08000002"?](https://access.redhat.com/site/articles/280653).

Matching an address to a device


If you need to further identify a device name from a hardware address, as mentioned in the Diagnostic Steps, please review [How do you map between scsi address <0 0 0 0> (or 0:0:0:0) and scsi device name (sda)?](https://access.redhat.com/site/solutions/164103).

Diagnostic Steps

Data Required


SCSI Errors are specific, detailed messages that describe the condition or status of the various parts of the SCSI IO Layer.

To interpret these messages, you will need:

  • The device path, which will look like:

    2:0:0:243:

    This is the hardware address of the device reporting the error and will be required if you need to swap hardware or identify which device is offline.

  • The SCSI Error Return Code, which will look similar to:

    kernel: sd 1:0:0:2: SCSI error: return code = 0x08070002

    Or

    sd 0:0:0:0: [sda] Sense Key : Medium Error [current]

  • The Additional Sense Key (if presented) which looks similar to

    kernel:     Add. Sense: Unrecovered read error

    Or

    sd 0:0:0:0: [sda] Add. Sense: Unrecovered read error
SBR
Product(s)
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.