# Error recovery control

In computing, error recovery control (ERC) (Western Digital: time-limited error recovery (TLER), Samsung/Hitachi: command completion time limit (CCTL)) is a feature of hard disks which allow a system administrator to configure the amount of time a drive's firmware is allowed to spend recovering from a read or write error. Limiting the recovery time allows for improved error handling in hardware or software RAID environments. In some cases, there is a conflict as to whether error handling should be undertaken by the hard drive or by the RAID implementation, which leads to drives being marked as unusable and significant performance degradation, when this could otherwise have been avoided.

## Overview

Modern hard drives feature an ability to recover from some read/write errors by internally remapping sectors and performing other forms of self-test and recovery. The process for this can sometimes take several seconds or (under heavy usage) minutes, during which time the drive is unresponsive. Hardware RAID controllers and software RAID implementations are designed to recognise a drive which does not respond within a few seconds, and mark it as unreliable, indicating that it should be withdrawn from use and the array rebuilt from parity data. This is a long process, degrades performance, and if more drives fail under the resulting additional workload, it may be catastrophic.
If the drive itself is inherently reliable but has some bad sectors, then TLER and similar features prevent a disk from being unnecessarily marked as 'failed' by limiting the time spent on correcting detected errors before advising the array controller of a failed operation. The array controller can then handle the data recovery for the limited amount involved, rather than marking the entire drive as faulty.

## Typical defaults

Effectively, TLER and similar features limit the performance of on-drive error handling, to allow hardware RAID controllers and software RAID implementations to handle the error if problematic.
Generally, Western Digital enterprise drives such as Raptor, Caviar RE2 and RE2-GP (RAID Edition) come with TLER Read "Enabled" (7 seconds) and TLER Write "Enabled" (7 seconds) while desktop drives such as Caviar SE, SE16, and GP come with TLER Read and Write Disabled (configured as 0 seconds, to disable).

## Standalone vs. RAID considerations

It is best for TLER to be "enabled" when in a RAID array to prevent the recovery time from a disk read or write error from exceeding the RAID implementation's timeout threshold. If a drive times out, the hard disk will need to be manually re-added to the array, requiring a re-build and re-synchronization of the hard disk. Enabling TLER seeks to prevent this by interrupting error correction before timeout, to report failures only for data segments. The result is increased reliability in a RAID array.
In a stand-alone configuration TLER should be disabled. As the drive is not redundant, reporting segments as failed will only increase manual intervention. Without a hardware RAID controller or a software RAID implementation to drop the disk, normal (no TLER) recovery ability is most stable.
In a software RAID configuration whether or not TLER is helpful is dependent on the operating system. For example, in FreeBSD the ATA/CAM stack controls the timeouts, and is set to progressively increase the timeouts as they occur. Thus, if a desktop disk without TLER starts delaying a response to a sector read, FreeBSD will retry the read with successively longer timeouts to prevent prematurely dropping the disk out of the array.
| Model | TLER default ( read / write ) | Stand-alone recommendation | RAID recommendation |
| Caviar, SE, SE16, GP, Raptor | Disabled ( 0s / 0s ) | Default | Enabled (if possible) |
| Caviar RE2, RE2-GP, Red | Enabled ( 7s / 7s ) | Disabled | Default |

### ZFS

The ZFS filesystem was designed to immediately write data to a sector that reports as bad or takes an excessively long time to read (such as non-TLER drives); this will usually force an immediate sector remap on a weak sector in most drives.

### RAID controllers

Disconnect timeout values for different hardware RAID controllers may vary between vendors; thus, TLER should trigger before the controller times out the drive. For example, 3ware 9650SE uses 20 seconds as the timeout, while for the LSI Logic used in IBM x-series it is 10 seconds.
Widely available Intel Matrix RAID / Intel Rapid Storage Technology, embedded in Intel server motherboards and modern desktop motherboards, is a pseudo-hardware controller, not a true hardware RAID controller.

### Software RAID

Linux mdadm simply holds and lets the drive complete its recovery – however, the default command timeout for the SCSI Disk layer (/sys/block/sd?/device/timeout) is 30 seconds, after which it will attempt to reset the drive, and if that fails, put the drive offline.

## Changing ERC
### ATA-8 standard

The 2006 ATA-8 standard defines a SCT Error Recovery Control command. For hard drives that implement this interface, the smartctl utility (part of the smartmontools package) can be used to change the error-recovery timeout via -l scterc. In 2018, ACS-4 added a functionality for the setting to persist across reboot; it is now supported by smartctl.
Controlling the timeout behavior through the smartctl utility may not work on all hard disk drives because some manufacturers have changed their desktop drives not to include the support for the ERC parameter, purportedly to force sales of their more expensive RAID/enterprise models. Richard Gregory, who wrote the original ERC patch for smartctl, reports that Western Digital retracted ERC support by releasing a new model without notice.
On Windows, the HDAT2 program is available in addition to smartctl (which is cross-platform).

### SCSI standard

SBC-4 describes a RECOVERY TIME LIMIT field in the Read-Write Error Recovery mode page used to define how the drive performs error recovery. The sdparm program can change this setting with --set=RTL.

### Vendor utilities
#### Western Digital

A WDTLER.EXE utility allows the enabling or disabling of the TLER parameter on Western Digital hard drives. This utility is written for DOS. The utility works on and makes changes to all compatible Western Digital hard disk drives connected to the computer. The change survives power-cycling. Western Digital used to mention the tool in an FAQ.
The utility comes with three batch files, TLERSCAN.BAT to get the current state of the TLER setting on all the hard drives, TLER-ON.BAT to enable TLER, and TLER-OFF.BAT to disable TLER. The included TLER-ON.BAT will set the Read & Write TLER time to seven seconds. It is possible to use the WDTLER.EXE utility directly with the -r# -w# parameters for a custom timeout.
Western Digital claims that using the WDTLER.EXE utility on newer drives can damage the firmware and make the disk unusable. The utility is no longer available from Western Digital, and new drives will not be able to have the TLER setting changed. RE disks are only suitable for RAID arrays and Caviar are only suitable for non-RAID use. The utility still works for older drives.

#### Hitachi

Hitachi customer service stated in 2009 that there is a Feature Tool for changing ERC (referred to as CCTL).

#### Seagate

Seagate provides a openSeaChest utility to allow you to interrogate and change many firmware settings including TLER. If you cannot use smartctl -l scterr,x,y to set the TLER, the relevant command-line commands are openSeaChest_Configure -d /dev/sg0 --sctReadTimer and openSeaChest_Configure -d /dev/sg0 --sctWriteTimer.