Root Filesystem Full and LVM Needs Extension

📖 ~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

Root partition reaches 95-100% usage and services begin failing writes.

Environment & Reproduction

Log growth, package cache accumulation, or insufficient LV allocation in LVM.

Root Cause Analysis

Run: df -h, sudo vgs, sudo lvs, and sudo pvs to view capacity.

Quick Triage

Identify large paths with du -xhd1 / and clean obvious transient data first.

Step-by-Step Diagnosis

Capture root usage and available VG free extents before extension.

Solution – Primary Fix

Capture lvextend and xfs_growfs success output.

Solution – Alternative Approaches

Extend LV: sudo lvextend -r -L +20G /dev// (or use xfs_growfs manually).

Verification & Acceptance Criteria

For XFS, run: sudo xfs_growfs / if resize flag was not used.

Rollback Plan

Clean package cache: sudo dnf clean all and rotate/compress large logs.

Prevention & Hardening

Confirm df -h shows increased available space and services recover.

Related Errors & Cross-Refs

Set log retention limits and capacity alerts before root usage crosses thresholds.

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

View all rhel-9 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

LVM shrink is risky for XFS; restore from snapshot/backup if extension was incorrect.