Debian 13 – LVM thin pool reaches 100% and volumes become read-only – 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

Thin-provisioned LVs stop accepting writes, causing service outages.

Environment & Reproduction

Common in VM hosts and snapshot-heavy environments.

sudo lvs -a -o+seg_monitor,data_percent,metadata_percent
dmesg | tail -n 80
df -h

Root Cause Analysis

Thin pool data or metadata area exhausted due to growth or orphan snapshots.

Quick Triage

Measure usage and list stale snapshots.

sudo lvs -a -o lv_name,vg_name,lv_attr,data_percent,metadata_percent
sudo lvs -a | grep -i snap
sudo vgs

Step-by-Step Diagnosis

Identify candidate LVs for cleanup or expansion.

sudo lvdisplay
sudo pvs
sudo vgs -o +vg_free

Solution – Primary Fix

Extend thin pool and metadata, then reactivate affected volumes.

sudo lvextend -L +20G vg0/thinpool
sudo lvextend -L +1G vg0/thinpool_tmeta
sudo lvconvert --repair vg0/thinpool
sudo lvchange -ay vg0/thinpool

Solution – Alternative Approaches

Delete obsolete snapshots to reclaim thin pool space quickly.

sudo lvs -a | grep snap
sudo lvremove /dev/vg0/old_snapshot

Verification & Acceptance Criteria

Thin pool usage drops below alert threshold and writes resume.

sudo lvs -a -o+data_percent,metadata_percent
dmesg | tail -n 40

Rollback Plan

Restore from backup if metadata repair cannot recover consistency.

sudo vgcfgbackup
sudo vgcfgrestore vg0

Prevention & Hardening

Set monitoring thresholds and automatic extension policy.

sudo lvmconfig --type full | grep thin_pool
sudo lvchange --monitor y vg0/thinpool

Related Errors & Cross-Refs

May coincide with filesystem remount read-only events.

Related tutorial: View the step-by-step tutorial for Debian 13.

View all Debian 13 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Debian LVM thin provisioning operational guidance.