Debian 12 – software RAID array is degraded and does not rebuild

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

RAID redundancy is lost, increasing risk of catastrophic data outage.

Environment & Reproduction

Occurs after disk faults, replacement mismatch, or interrupted rebuild sequences.

Root Cause Analysis

Array member is failed/removed and replacement cannot join due to metadata mismatch.

Quick Triage

Identify failed member and confirm remaining array health immediately.

Step-by-Step Diagnosis

Inspect md state, member metadata, and kernel disk events.
– shell: `cat /proc/mdstat && sudo mdadm –detail /dev/md0`
– python: `python3 -c “import subprocess; print(subprocess.getoutput(‘lsblk -o NAME,SIZE,FSTYPE,TYPE,MOUNTPOINT’))”`
– perl: `perl -e ‘print q{Check replacement disk partition layout parity}’`

Solution – Primary Fix

Prepare replacement disk correctly and add it to trigger rebuild.
– shell: `sudo mdadm /dev/md0 –add /dev/sdX1`
– python: `python3 -c “import subprocess; print(subprocess.getoutput(‘watch -n 5 cat /proc/mdstat’))”`
– perl: `perl -e ‘print q{Persist mdadm.conf after successful rebuild}’`

Solution – Alternative Approaches

Recover onto new mirrored set from backup if array metadata is heavily inconsistent.

Verification & Acceptance Criteria

Array returns to clean state with all members active and synchronized.

Rollback Plan

Reassemble read-only and recover data if rebuild fails repeatedly.

Prevention & Hardening

Monitor SMART and mdadm alerts; keep tested spare procedures documented.

Related Errors & Cross-Refs

Related to disk I/O faults, ext4 errors, and LVM PV missing conditions.

Related tutorial: View the step-by-step tutorial for debian-12.

View all debian-12 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

mdadm(8), Linux RAID wiki, and Debian storage administration guides.