openstack/diskimage-builder
Code Issues Proposed changes
a8d8724e3c
diskimage-builder/elements/iso
History
Gloria f30ddfc379 Adds debian support to iso element 
Adds support for debian to iso.
Updated README to further clarify what the element does.

Change-Id: I17ac89cfbc84365860c591fab0e4c78123035983
Co-Authored-By: zhangjian <jian.zhang8@hpe.com>
2015-09-23 23:55:18 -07:00
..
cleanup.d Adds debian support to iso element 2015-09-23 23:55:18 -07:00
post-install.d Adds debian support to iso element 2015-09-23 23:55:18 -07:00
element-deps Add grub2 element 2015-06-02 05:35:03 +00:00
package-installs.yaml Adds debian support to iso element 2015-09-23 23:55:18 -07:00
pkg-map Adds debian support to iso element 2015-09-23 23:55:18 -07:00
README.rst Adds debian support to iso element 2015-09-23 23:55:18 -07:00

README.rst

iso

Generates a bootable ISO image from the kernel/ramdisk generated by the elements baremetal, ironic-agent 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 * debian

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.

ironic-agent element

When used with ironic-agent element, this generates a bootable ISO image named <image-name>.iso which boots the agent kernel and agent ramdisk.

REFERENCES

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