Chapter 8. Configuring maximum time for storage error recovery with eh_deadline
You can configure the maximum allowed time to recover failed SCSI devices. This configuration guarantees an I/O response time even when storage hardware becomes unresponsive due to a failure.
8.1. The eh_deadline parameter
The SCSI error handling (EH) mechanism attempts to perform error recovery on failed SCSI devices. The SCSI host object
eh_deadline parameter enables you to configure the maximum amount of time for the recovery. After the configured time expires, SCSI EH stops and resets the entire host bus adapter (HBA).
eh_deadline can reduce the time:
- to shut off a failed path,
- to switch a path, or
- to disable a RAID slice.
eh_deadline expires, SCSI EH resets the HBA, which affects all target paths on that HBA, not only the failing one. If some of the redundant paths are not available for other reasons, I/O errors might occur. Enable
eh_deadline only if you have a fully redundant multipath configuration on all targets.
Scenarios when eh_deadline is useful
In most scenarios, you do not need to enable
eh_deadline can be useful in certain specific scenarios, for example if a link loss occurs between a Fibre Channel (FC) switch and a target port, and the HBA does not receive Registered State Change Notifications (RSCNs). In such a case, I/O requests and error recovery commands all time out rather than encounter an error. Setting
eh_deadline in this environment puts an upper limit on the recovery time. That enables the failed I/O to be retried on another available path by DM Multipath.
Under the following conditions, the
eh_deadline functionality provides no additional benefit, because the I/O and error recovery commands fail immediately, which allows DM Multipath to retry:
- If RSCNs are enabled
- If the HBA does not register the link becoming unavailable
The value of the
eh_deadline is specified in seconds.
The default setting is
off, which disables the time limit and allows all of the error recovery to take place.
8.2. Setting the eh_deadline parameter
This procedure configures the value of the
eh_deadline parameter to limit the maximum SCSI recovery time.
You can configure
eh_deadlineusing either of the following methods:
Write the number of seconds into the
- Kernel parameter
Set a default value for all SCSI HBAs using the