Debian 12 – mdadm RAID array degraded or not assembling – Fix & Prevention

📖 ~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 array shows degraded state, risking redundancy and performance.

Environment & Reproduction

Occurs after disk failure, cable issue, or metadata mismatch.

cat /etc/os-release
cat /proc/mdstat
sudo mdadm --detail /dev/md0

Root Cause Analysis

One or more member devices dropped out or failed assembly at boot.

Quick Triage

Identify failed member and collect SMART and mdadm details.

cat /proc/mdstat
sudo mdadm --examine /dev/sd[bcd]1
sudo smartctl -H /dev/sdX

Step-by-Step Diagnosis

Confirm member UUID consistency and current array event counts.

sudo mdadm --detail /dev/md0
sudo mdadm --examine --scan
journalctl -b | grep -i mdadm

Solution – Primary Fix

Replace failed disk or re-add healthy member and monitor rebuild.

sudo mdadm /dev/md0 --fail /dev/sdX1 --remove /dev/sdX1
sudo mdadm /dev/md0 --add /dev/sdY1
watch -n 5 cat /proc/mdstat

Solution – Alternative Approaches

Assemble array manually in rescue mode when auto-assembly fails.

sudo mdadm --assemble --scan
sudo update-initramfs -u

Verification & Acceptance Criteria

Array returns to clean state with all expected active members.

cat /proc/mdstat
sudo mdadm --detail /dev/md0 | grep -E 'State|Active Devices'

Rollback Plan

Keep failed drive detached and restore data from backup if rebuild fails.

# restore from backup snapshot if RAID consistency cannot be recovered

Prevention & Hardening

Enable RAID monitoring alerts and periodic SMART checks.

sudo dpkg-reconfigure mdadm
sudo smartctl -a /dev/sdX | grep -E 'Reallocated|Pending'

Related Errors & Cross-Refs

Related messages include mdadm array not clean and device faulty.

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

Debian mdadm administration and Linux RAID recovery docs.