beoboot – Generate Scyld ClusterWare boot images


beoboot [-h] [-v] [-2] [-a] [-i] [-n] [-o output_file] [-L dir, –libdir dir] [-k kernimg, –kernel kernimg] [-c cmdline, –cmdline cmdline] [-m dir, –modules dir]


beoboot is a script that builds images to boot for Scyld compute nodes.

The final boot image is provided by one or more master nodes designated as “boot masters”. This final boot image has the run-time kernel and initial information needed to contact an operational master.



Display a help message and exit.


Display version information and exit.


Create a phase 2 image. This image contains the final kernel to run.


Create stand-alone images (kernel and ramdisk). These images will be appropriate for use with other boot mechanisms. The kernel and ramdisk image will be stored in: outfile and outfile.initrd


Create a netboot image. If no output_file argument is specified, then the image file will be named /var/beowulf/boot.img.

-o output_file

Set output filename to output_file.

-L, --libdir dir

Find beoboot files in dir instead of /usr/lib/beoboot/.

-k, --kernel kernimg

Use kernimg as the kernel image instead of the image given in the configuration file (final boot image only).

If this is not specified on the command line, the default is taken out of /etc/beowulf/config. If it is not specified there, /boot/vmlinuz is used.

-c, --cmdline cmdline

Use the command line cmdline instead of the default “kernelcommandline” line found in the etc/beowulf/config config file.

-m, --modules dir

Look for modules matching the kernel image in dir instead of /lib/modules/<kernelversion>, which is the default.


When you are making a final boot image, you must be running the kernel you are putting in the image, whether this kernel is specified on the command line or in /etc/beowulf/config.


Creating a final boot image:

Building phase 2 file system image in /tmp/beoboot.6684...
ram disk image size (uncompressed): 1888K
ram disk image size (compressed): 864K
Kernel image is:    "/tmp/beoboot.6684".
Initial ramdisk is: "/tmp/beoboot.6684.initrd".
Netboot image is in: /var/beowulf/boot.img