Oracle Linux 10 – dracut initramfs missing storage driver after update – 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

System fails to boot and drops to emergency shell because root device is not found.

Environment & Reproduction

Usually appears after kernel upgrade on systems with custom storage stacks.

journalctl -b -1 -p err --no-pager
lsinitrd /boot/initramfs-$(uname -r).img | head

Root Cause Analysis

Required storage modules were omitted from initramfs due to dracut config drift or missing dependencies.

Quick Triage

Identify missing module names and current root mapping.

lsblk -f
cat /etc/fstab
modinfo 

Step-by-Step Diagnosis

Check dracut configs and generated image contents.

grep -R . /etc/dracut.conf /etc/dracut.conf.d
lsinitrd /boot/initramfs-$(uname -r).img | grep -i ''
dracut --print-cmdline

Solution – Primary Fix

Force include driver and rebuild initramfs for target kernel.

echo 'add_drivers+="  "' | sudo tee /etc/dracut.conf.d/storage.conf
sudo dracut -f /boot/initramfs-$(uname -r).img $(uname -r)
sudo grubby --info=DEFAULT

Solution – Alternative Approaches

Boot previous kernel and regenerate all initramfs images.

sudo dracut -f --regenerate-all
sudo dnf reinstall -y kernel-core

Verification & Acceptance Criteria

Host boots normally and root filesystem mounts without emergency prompt.

reboot
systemctl is-system-running
journalctl -b -p err --no-pager

Rollback Plan

Select prior known-good kernel and remove faulty dracut override.

sudo rm -f /etc/dracut.conf.d/storage.conf
sudo grubby --set-default /boot/vmlinuz-

Prevention & Hardening

Validate bootability in maintenance window after each kernel update.

lsinitrd /boot/initramfs-$(uname -r).img | grep -i ''
cat /proc/cmdline

Related Errors & Cross-Refs

Related to incorrect UUID in fstab, LVM activation failures, and degraded RAID arrays.

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

RHEL dracut and emergency boot troubleshooting documentation.