Oracle Linux 10 – DNF upgrade aborted by modular dependency conflicts – Fix & Prevention

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

`dnf upgrade` exits with modular filtering or conflicting requests, leaving hosts partially patched and inconsistent across fleets.

Environment & Reproduction

Seen after enabling third-party repos or carrying older stream selections into RHEL 10.

dnf module list --enabled
dnf upgrade --refresh
dnf repoquery --unsatisfied

Root Cause Analysis

Conflicting module streams pin package versions that cannot satisfy current dependency chains in enabled repositories.

Quick Triage

Identify the blocking module quickly.

dnf -v upgrade 2>&1 | tail -n 80
dnf module list --enabled
journalctl -n 50 --no-pager

Step-by-Step Diagnosis

Trace stream relationships and package providers.

dnf module info nodejs
dnf repoquery --whatrequires 'module(nodejs:*)'
dnf distro-sync --assumeno

Solution – Primary Fix

Reset problematic stream and switch to supported defaults before upgrade.

sudo dnf module reset nodejs -y
sudo dnf module enable nodejs:default -y
sudo dnf distro-sync -y
sudo dnf upgrade -y

Solution – Alternative Approaches

Disable conflicting repositories or use explicit stream versions validated for your stack.

sudo dnf config-manager --set-disabled epel
sudo dnf module enable nodejs:22 -y
sudo dnf upgrade --nobest -y

Verification & Acceptance Criteria

No unresolved dependencies and full transaction completion.

dnf check
dnf repoquery --unsatisfied
rpm -qa | wc -l

Rollback Plan

Restore prior module state if application regression appears.

sudo dnf history list
sudo dnf history undo last -y
sudo dnf module reset nodejs -y

Prevention & Hardening

Pin approved streams in configuration management and run preflight dependency checks.

dnf module list --enabled > /var/tmp/enabled-modules.txt
dnf check

Related Errors & Cross-Refs

Related to GPG signature errors, repo priority misconfiguration, and stale local metadata.

Related tutorial: View the step-by-step tutorial for oracle-linux-10.

View all oracle-linux-10 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Oracle Linux modularity and DNF troubleshooting documentation for stream management and lifecycle guidance.