CentOS Stream 9 – Common Problem 117 – 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 fails to find root after a kernel update on Stream 9.

Environment & Reproduction

dracut omits required driver (NVMe, virtio_scsi, multipath) during rebuild.

Root Cause Analysis

Storage driver added later not listed in /etc/dracut.conf.d.

Quick Triage

lsinitrd /boot/initramfs-$(uname -r).img | grep .

Step-by-Step Diagnosis

Boot the previous kernel from the grub menu and inspect logs.

Solution – Primary Fix

Add required drivers: echo ‘add_drivers+=” nvme “‘ > /etc/dracut.conf.d/99-local.conf; dracut -fv.

Solution – Alternative Approaches

Use hostonly=no to build a generic initramfs for cloning.

Verification & Acceptance Criteria

Reboot succeeds into the new kernel and lsblk shows root.

Rollback Plan

Reinstall the kernel package which regenerates the original initramfs.

Prevention & Hardening

Test kernel updates in a staging VM and snapshot before reboot.

Related Errors & Cross-Refs

Related: GRUB BLS entries and root LV detection.

Related tutorial: View the step-by-step tutorial for centos-stream-9.

View all centos-stream-9 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

dracut(8) man page and Red Hat kernel admin guide.