RHEL 8 – leapp Preupgrade Inhibitors Block In-Place Upgrade Planning

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

Upgrade planning stalls because leapp preupgrade reports blocking inhibitors.

Environment & Reproduction

Occurs on long-lived RHEL 8 hosts with legacy packages, custom kernels, or unsupported modules.

Root Cause Analysis

Current system state violates supported upgrade prerequisites and dependency constraints.

Quick Triage

Run leapp preupgrade and inspect generated reports, then correlate warnings with journalctl evidence.

Step-by-Step Diagnosis

Review inhibitor details for package conflicts, kernel modules, and repository readiness.

Solution – Primary Fix

Remediate each inhibitor item, align repositories and packages, then rerun preupgrade checks.

Solution – Alternative Approaches

Use side-by-side migration when in-place path remains unsupported for critical workloads.

Verification & Acceptance Criteria

leapp preupgrade completes without inhibitors and change record is approved for execution.

Rollback Plan

Pause upgrade and restore baseline package state if remediation introduces service risk.

Prevention & Hardening

Continuously track lifecycle prerequisites so hosts stay upgrade-ready throughout their lifespan.

Related Errors & Cross-Refs

Leapp inhibitors found, unsupported kernel modules, repository mapping failures.

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

View all rhel-8 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Red Hat in-place upgrade planning, leapp tooling, and lifecycle support policy documents.