RHEL 7 yum Dependency Conflict with EPEL Packages

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

yum reports unresolved dependencies and refuses to complete transactions. Patching stalls and dependent service upgrades are blocked.

Environment & Reproduction

Occurs on RHEL 7 with mixed repositories where package versions overlap. firewalld and SELinux are usually unrelated but checked to avoid hidden side effects.

Root Cause Analysis

Competing repositories provide incompatible package versions or ABI expectations. Existing pinned packages and prior yum decisions can amplify conflicts.

Quick Triage

Run yum repolist and dependency diagnostics, inspect recently changed repos, and review journalctl for automation context. Confirm service impact scope.

Step-by-Step Diagnosis

Identify conflicting NEVRAs, validate repo priorities, and simulate transaction with explicit include/exclude rules. Check package provenance carefully.

Solution – Primary Fix

Set repository priorities, disable conflicting sources for the transaction, and align package versions intentionally. Apply with yum, then restart impacted services via systemctl.

Solution – Alternative Approaches

Use internal curated mirrors, lock critical package versions, or containerize conflicting dependency stacks to isolate risk.

Verification & Acceptance Criteria

yum transactions complete cleanly and required packages resolve from intended repos. service functionality remains intact and journalctl shows no dependency crash fallout.

Rollback Plan

Use yum history undo to revert problematic transactions and restore prior repo files. Reinstate previous service and firewall posture if changed.

Prevention & Hardening

Formalize repository governance, audit package origins, and test upgrades in staging. Alert on unresolved dependency patterns in automation logs.

Related Errors & Cross-Refs

Related errors include obsoletes loops and protected package constraints. See linked tutorial 9068 for repository strategy on RHEL 7.

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

View all rhel-7 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

See man yum, man yum.conf, man systemctl, man service, man firewall-cmd, SELinux documentation, and man journalctl.