Debian 9 – LVM thin pool reaches 100% and blocks writes

📖 ~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 pool exhaustion halts writes and can pause or crash dependent services.

Environment & Reproduction

Seen on virtualization or container hosts using LVM thin provisioning without growth controls.

# Capture baseline
lvs -a -o +seg_monitor,data_percent,metadata_percent
vgs
pvs

Root Cause Analysis

Data or metadata in the thin pool reached full utilization and write allocation cannot continue.

Quick Triage

Check both data and metadata percentages and identify largest thin volumes.

# Quick triage
lvs -a -o lv_name,vg_name,data_percent,metadata_percent,lv_size
df -h

Step-by-Step Diagnosis

Correlate pool exhaustion timeline with workload growth and snapshot retention.

# Detailed diagnosis
journalctl -p err -n 150 --no-pager | grep -Ei thin|lvm
lvs -a -o +devices

Solution – Primary Fix

Extend thin pool capacity and enable auto-extension policy.

# Primary fix
sudo lvextend -L +20G /dev//
sudo lvchange --monitor y /dev//
sudo lvs -a -o +data_percent,metadata_percent

Solution – Alternative Approaches

Delete stale snapshots and reclaim space from unused logical volumes.

# Alternatives
lvs -a | grep snapshot
sudo lvremove /dev//

Verification & Acceptance Criteria

Thin pool utilization drops below threshold and write operations succeed.

# Verify
lvs -a -o +data_percent,metadata_percent
touch /var/tmp/thinpool-write-test

Rollback Plan

Restore from snapshot/backup if volume resizing introduces instability.

# Rollback
vgcfgbackup
vgcfgrestore 

Prevention & Hardening

Enable threshold alerts and autoextend settings for thin pools.

# Hardening
cat /etc/lvm/lvm.conf | grep -n thin_pool
lvs -a -o +seg_monitor

Related Errors & Cross-Refs

Related to thin pool out of data space and metadata full conditions.

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

View all Debian 9 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

LVM thin provisioning operations and capacity management documentation.