Product SiteDocumentation Site

22.5. Verifying the Initial RAM Disk Image

The job of the initial RAM disk image is to preload the block device modules, such as for IDE, SCSI or RAID, so that the root file system, on which those modules normally reside, can then be accessed and mounted. On Fedora 24 systems, whenever a new kernel is installed using either the DNF, PackageKit, or RPM package manager, the Dracut utility is always called by the installation scripts to create an initramfs (initial RAM disk image).
On all architectures other than IBM eServer System i (see the section called “ Verifying the Initial RAM Disk Image and Kernel on IBM eServer System i ”), you can create an initramfs by running the dracut command. However, you usually don't need to create an initramfs manually: this step is automatically performed if the kernel and its associated packages are installed or upgraded from RPM packages distributed by The Fedora Project.
On architectures that use the GRUB 2 boot loader, you can verify that an initramfs corresponding to your current kernel version exists and is specified correctly in the /boot/grub2/grub.cfg configuration file by following this procedure:
Procedure 22.1. Verifying the Initial RAM Disk Image
  1. As root, list the contents in the /boot/ directory and find the kernel (vmlinuz-kernel_version) and initramfs-kernel_version with the latest (most recent) version number:
    Example 22.1. Ensuring that the kernel and initramfs versions match
    ~]# ls /boot/
    config-3.17.4-302.fc21.x86_64
    config-3.17.6-300.fc21.x86_64
    config-3.17.7-300.fc21.x86_64
    efi
    elf-memtest86+-5.01
    extlinux
    grub2
    initramfs-0-rescue-db90b4e3715b42daa871351439343ca4.img
    initramfs-3.17.4-302.fc21.x86_64.img
    initramfs-3.17.6-300.fc21.x86_64.img
    initramfs-3.17.7-300.fc21.x86_64.img
    initrd-plymouth.img
    lost+found
    memtest86+-5.01
    System.map-3.17.4-302.fc21.x86_64
    System.map-3.17.6-300.fc21.x86_64
    System.map-3.17.7-300.fc21.x86_64
    vmlinuz-0-rescue-db90b4e3715b42daa871351439343ca4
    vmlinuz-3.17.4-302.fc21.x86_64
    vmlinuz-3.17.6-300.fc21.x86_64
    vmlinuz-3.17.7-300.fc21.x86_64

    • we have three kernels installed (or, more correctly, three kernel files are present in the /boot/ directory),
    • the latest kernel is vmlinuz-3.17.7-300.fc21.x86_64, and
    • an initramfs file matching our kernel version, initramfs-3.17.7-300.fc21.x86_64.img, also exists.

    initrd files in the /boot/ directory are not the same as initramfs files

    In the /boot/ directory you might find several initrd-kernel_versionkdump.img files. These are special files created by the kdump mechanism for kernel debugging purposes, are not used to boot the system, and can safely be ignored. For more information on kdump, see the Red Hat Enterprise Linux 7 Kernel Crash Dump Guide.
  2. (Optional) If your initramfs-kernel_version file does not match the version of the latest kernel in /boot, or, in certain other situations, you might need to generate an initramfs file with the Dracut utility. Simply invoking dracut as root without options causes it to generate an initramfs file in the /boot/ directory for the latest kernel present in that directory:
    ~]# dracut
    You must use the --force option if you want dracut to overwrite an existing initramfs (for example, if your initramfs has become corrupt). Otherwise dracut will refuse to overwrite the existing initramfs file:
    ~]# dracut
    F: Will not override existing initramfs (/boot/initramfs-3.17.7-300.fc21.x86_64.img) without --force
    You can create an initramfs in the current directory by calling dracut initramfs_name kernel_version, for example:
    ~]# dracut "initramfs-$(uname -r).img" $(uname -r)
    If you need to specify specific kernel modules to be preloaded, add the names of those modules (minus any file name suffixes such as .ko) inside the parentheses of the add_dracutmodules="module [more_modules]" directive of the /etc/dracut.conf configuration file. You can list the file contents of an initramfs image file created by dracut by using the lsinitrd initramfs_file command:
    ~]# lsinitrd /boot/initramfs-3.17.7-300.fc21.x86_64.img
    Image: /boot/initramfs-3.17.7-300.fc21.x86_64.img: 18M
    ========================================================================
    Version: dracut-038-31.git20141204.fc21
    [output truncated]
    See man dracut and man dracut.conf for more information on options and usage.
  3. Examine the /boot/grub2/grub.cfg configuration file to ensure that an initramfs-kernel_version.img file exists for the kernel version you are booting. For example:
    ~]# grep initramfs /boot/grub2/grub.cfg
    	initrd16 /initramfs-3.17.7-300.fc21.x86_64.img
    	initrd16 /initramfs-3.17.6-300.fc21.x86_64.img
    	initrd16 /initramfs-3.17.4-302.fc21.x86_64.img
    	initrd16 /initramfs-0-rescue-db90b4e3715b42daa871351439343ca4.img
    See Section 22.6, “Verifying the Boot Loader” for more information on how to read and update the /boot/grub2/grub.cfg file.

Verifying the Initial RAM Disk Image and Kernel on IBM eServer System i

On IBM eServer System i machines, the initial RAM disk and kernel files are combined into a single file, which is created with the addRamDisk command. This step is performed automatically if the kernel and its associated packages are installed or upgraded from the RPM packages distributed by The Fedora Project; thus, it does not need to be executed manually. To verify that it was created, run the following command as root to make sure the /boot/vmlinitrd-kernel_version file already exists:
ls -l /boot/
The kernel_version should match the version of the kernel just installed.