CentOS Stream 10 – Common Problem 125 – Diagnosis and Fix

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

Major version upgrade aborts midway leaving system in inconsistent state.

Environment & Reproduction

Reported on hosts with broken module streams or third-party repos enabled.

Root Cause Analysis

dnf transaction fails on dependency conflicts during upgrade reboot.

Quick Triage

Boot last working kernel and inspect /var/log/dnf.rpm.log.

Step-by-Step Diagnosis

Run dnf history list to identify failed transaction ID.

Solution – Primary Fix

Roll back with dnf history rollback or dnf history undo to last good state.

Solution – Alternative Approaches

Disable third-party repos and retry upgrade with –allowerasing.

Verification & Acceptance Criteria

rpm -Va and dnf check report clean state after rollback.

Rollback Plan

Restore filesystem snapshot if rollback cannot reconcile state.

Prevention & Hardening

Practice major upgrades in staging with full snapshots.

Related Errors & Cross-Refs

Linked to leapp utility and module stream issues.

Related tutorial: View the step-by-step tutorial for centos-stream-10.

View all centos-stream-10 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Red Hat upgrading and migration documentation.