openstack/diskimage-builder
Code Issues Proposed changes
a33ddb89f1
diskimage-builder/elements/iso
History
Shivanand Tendulker 0bbe91af82 UEFI secure boot support for iso element. 
This adds support to UEFI secure boot by copying signed shim and
grub bootloaders into ramdisk image.

Closes-Bug: 1419707
Change-Id: I1193cd3a9011855a6804966a31c7c0e28da90ada
2015-03-10 00:39:14 -07:00
..
cleanup.d UEFI secure boot support for iso element. 2015-03-10 00:39:14 -07:00
post-install.d UEFI secure boot support for iso element. 2015-03-10 00:39:14 -07:00
element-deps UEFI secure boot support for iso element. 2015-03-10 00:39:14 -07:00
package-installs.yaml UEFI secure boot support for iso element. 2015-03-10 00:39:14 -07:00
pkg-map UEFI secure boot support for iso element. 2015-03-10 00:39:14 -07:00
README.rst Create docs site containing element READMEs 2015-02-10 11:45:35 -08:00

README.rst

iso

Generates a bootable ISO image from the kernel/ramdisk generated by the elements baremetal or ramdisk. It uses isolinux to boot on BIOS machines and grub to boot on EFI machines.

This element has been tested on the following distro(s): * ubuntu * fedora

NOTE: For other distros, please make sure the isolinux.bin file exists at /usr/lib/syslinux/isolinux.bin.

baremetal element

When used with baremetal element, this generates a bootable ISO image named <image-name>-boot.iso booting the generated kernel and ramdisk. It also automatically appends kernel command-line argument 'root=UUID=<uuid-of-the-root-partition>'. Any more kernel command-line arguments required may be provided by specifying them in DIB_BOOT_ISO_KERNEL_CMDLINE_ARGS.

NOTE: It uses pre-built efiboot.img by default to work for UEFI machines. This is because of a bug in latest version of grub[1]. The user may choose to avoid using pre-built binary and build efiboot.img on their own machine by setting the environment variable DIB_UEFI_ISO_BUILD_EFIBOOT to 1 (this might work only on certain versions of grub). The current efiboot.img was generated by the method build_efiboot_img() in 100-build-iso on Ubuntu 13.10 with grub 2.00-19ubuntu2.1.

ramdisk element

When used with ramdisk element, this generates a bootable ISO image named <image-name>.iso booting the generated kernel and ramdisk. It also automatically appends kernel command-line argument 'boot_method=vmedia' which is required for Ironic drivers iscsi_ilo.

REFERENCES

[1] https://bugs.launchpad.net/ubuntu/+source/grub2/+bug/1378658