From Fedora Project Wiki


Boot a root filesystem located on a Network Block Device (NBD) using dracut. For more information on nbd, please see [1].

How to test

Prepare NBD server and a root fs containing the OS version we want to boot.

  1. Install needed packages
    yum install nbd anaconda anaconda-runtime
  2. Prepare a disk image (can be a file, disk partition, LVM volume):
     dd if=/dev/zero of=/tmp/nbd.img bs=1M count=5120
  3. Create a file system on the image and mount it so we can install onto it
     mkfs.ext3 /tmp/nbd.img
    mkdir -p /mnt/nbdroot
    mount -o loop /tmp/nbd.img /mnt/nbdroot
  4. Install the OS under /mnt/nbdroot using anaconda
     anaconda --text --rootpath=/mnt/nbdroot --method=
As a result of RHBZ #519665 you may want to try using yum instead. You should modify your yum repos to explicitly list architecture and release version instead of meta variables:
 yum groupinstall Base --installroot=/mnt/nbdroot
  1. Export the image with NBD (2345 is the TCP port). Make sure your firewall is not blocking traffic to the NBD server.
     nbd-server 2345 /tmp/nbd.img

Prepare the test system to use the exported NBD image. You need to boot the kernel and initrd.img generated from Dracut with the correct parameters. You can use DHCP/PXE, bootable floppy/CD-ROM/USB drive or local /boot disk on the test system. This example uses local /boot disk.

  1. The test system is pre-installed and /boot is on the local disk
  2. You need to use dracut to generate initrd.img and get the kernel image as well. If the test system has the same OS version as the one installed on the NBD image you can generate the dracut image on the test system:
     dracut /boot/dracut.img $(uname -r)
  3. Place the vmlinuz and initrd.img files under /boot and configure grub.conf. Adjust server IP and port values. UUID is the value from blkid executed on the loopback mounted (NBD) image on the server. It should look like:
    # grub.conf generated by anaconda
    # Note that you do not have to rerun grub after making changes to this file
    # NOTICE: You have a /boot partition. This means that
    # all kernel and initrd paths are relative to /boot/, eg.
    # root (hd0,0)
    # kernel /vmlinuz-version ro root=/dev/sda1
    # initrd /initrd-version.img
    title dracut NBD
    root (hd0,0)
    kernel /vmlinuz- rw root=UUID=123456 netroot=nbd: ip=eth0:dhcp
    initrd /dracut.img
  4. Reboot the test system
You may want to use root=nbd:ip:port:fstype instead of root=UUID= netroot=. root=nbd: has been tested more and works.

Expected Results

The following must be true to consider this a successful test run.

  1. The system will boot from the kernel+initrd pair
  2. init will bring up the network interface and mount the NBD image
  3. The init process will successfully switch to the new root and the system will boot into default runlevel