CentOS Stream 10 – Common Problem 118 – 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

Boot hangs waiting for root device because driver is missing in initramfs.

Environment & Reproduction

Triggered by storage controller swap or new NVMe firmware paths.

Root Cause Analysis

dracut omitted required kernel module from generated image.

Quick Triage

Boot rescue media and run lsinitrd /boot/initramfs-$(uname -r).img.

Step-by-Step Diagnosis

Identify missing module via dmesg and lspci -k output.

Solution – Primary Fix

Rebuild initramfs with dracut –add-drivers and verify with lsinitrd.

Solution – Alternative Approaches

Use host-only=no temporarily to include broader driver set.

Verification & Acceptance Criteria

Host boots into the new kernel reliably across reboots.

Rollback Plan

Restore previous initramfs from /boot/initramfs-prev image if needed.

Prevention & Hardening

Test dracut after firmware or controller changes in staging.

Related Errors & Cross-Refs

Linked to LVM, multipath, and iSCSI activation.

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

dracut.cmdline and dracut.conf manuals.