RHEL 10 – DNF Metadata Cache Corruption Causes Update Failures – 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 update fails with checksum or repomd errors, delaying security patch deployment.

Environment & Reproduction

Seen on hosts with interrupted mirror sync or stale local cache.

cat /etc/redhat-release
dnf repolist -v

Root Cause Analysis

Local metadata differs from remote repository state, so dnf cannot validate package indexes.

Quick Triage

Confirm repository health and test a metadata refresh path.

dnf clean metadata
dnf makecache --refresh

Step-by-Step Diagnosis

Inspect repo config and dnf logs for failing mirror entries.

grep -R "^baseurl|^metalink" /etc/yum.repos.d
journalctl -u dnf* -n 200 --no-pager

Solution – Primary Fix

Purge cache fully and rebuild against healthy mirrors.

dnf clean all
rm -rf /var/cache/dnf/*
dnf makecache --refresh
dnf -y update

Solution – Alternative Approaches

Temporarily pin to a known-good mirror or local satellite mirror if WAN mirrors are unstable.

dnf config-manager --setopt='*.skip_if_unavailable=true' --save

Verification & Acceptance Criteria

Updates complete with no checksum warnings.

dnf check-update
dnf history list | head

Rollback Plan

Restore previous repo files if mirror override causes package drift.

cp -a /etc/yum.repos.d /etc/yum.repos.d.rollback.$(date +%F)

Prevention & Hardening

Use managed mirrors and monitor metadata age.

systemctl enable --now dnf-makecache.timer
journalctl -u dnf-makecache.timer -n 50 --no-pager

Related Errors & Cross-Refs

Repomd.xml mismatch, checksum mismatch, failed to synchronize cache.

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

View all rhel-10 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

RHEL package management docs, dnf configuration reference.