## TL;DR
A cleaning required flag means the drive heads have accumulated enough debris or wear errors that the drive refuses or degrades writes. Load a cleaning cartridge with remaining cycles, let the drive complete its cleaning cycle, check the drive error counters, and watch the next backup: a flag that returns immediately points at a worn drive or bad media batch, not dirt.

```text
tape drive "cleaning required" error
```

## Use this when
- Backup jobs fail or warn with tape drive cleaning required.
- Drive logs show rising soft error rates before the flag.
- The flag appears soon after cleaning with one particular media set.

## Not for this skill when
- The library arm cannot move tapes at all. Mechanical library fault.
- A drive write error with sense codes persists after cleaning. That needs drive-level diagnosis.

## Steps
1. Check the drive status and error counters in the library or backup software and note soft versus hard errors. Verify: the cleaning demand and error profile are recorded
2. Confirm the cleaning cartridge has cycles remaining and is the correct type for the drive generation. Verify: a usable cleaning cartridge is available
3. Run the cleaning cycle through the library or manually as the library design requires, letting it finish fully. Verify: the cleaning required flag clears
4. Run a short test backup to a scratch tape and read it back. Verify: the test writes and verifies without new cleaning demands
5. If the flag returns within a few backups, replace suspect media and plan drive service. Verify: recurrence is tracked and escalated if it repeats

## Variant phrasings
### lto drive cleaning required backup failed
The LTO phrasing.
### tape drive needs cleaning error fix
The plain variant.
### backup job failed clean drive tape
The job wording.

Compatibility: LTO-7, LTO-8 and LTO-9 drives in standalone and library configurations with standard cleaning cartridges.

## Why it happens
Tape heads contact media physically, so debris and oxide build-up are inevitable, and drives track error rates to demand cleaning before hard failures start destroying backups. Cleaning cartridges are abrasive by design with a fixed cycle count, which is why an exhausted cleaning tape silently fails to clear the flag.

## Edge cases / pitfalls
- Log cleaning cycles and cartridge counts. An unlogged cleaning tape is usually an exhausted one.
- Cleaning more often than the drive asks accelerates head wear. Follow the flag, not a calendar.
- If only tapes from one batch trigger flags, quarantine the batch before servicing the drive.

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_qYSrqpInrvW78niFa3J1Fg
