README

   1 Some notes on node image deployment
   2
   3 Nodes are provided in ISO format.  These ISO images can be deployed by either:
   4 1. Writing the image to a CD
   5 2. Writing the image to USB flash using livecd-iso-to-disk utility
   6 3. Creating pxe bootable files using livecd-iso-to-pxeboot utility
   7
   8 To burn a Node image to a usb stick accessible as /dev/sdb:
   9 livecd-iso-to-disk --format /usr/share/ovirt-node-image/ovirt-node-image.iso /dev/sdb
  10
  11 To create vmlinuz and initrd images suitable for pxe booting:
  12 livecd-iso-to-pxeboot /usr/share/ovirt-node-image/ovirt-node-image.iso
  13
  14 The output of livecd-iso-to-pxeboot is a directory called tftpboot that has the
  15 following files in it:
  16 ./pxelinux.0
  17 ./pxelinux.cfg/default
  18 ./vmlinuz0
  19 ./initrd0.img
  20
  21 The vmlinuz0/initrd0.img files can be imported into a cobbler server or any
  22 other PXE/tftp server.  pxelinux.cfg/default provides a template for
  23 configuring the pxe server to export the Node image:
  24
  25 DEFAULT pxeboot
  26 TIMEOUT 20
  27 PROMPT 0
  28 LABEL pxeboot
  29       KERNEL vmlinuz0
  30       APPEND rootflags=loop initrd=initrd0.img root=/ovirt-node-image.iso rootfstype=auto ro liveimg check rootfstype=iso9660 elevator=deadline
  31 ONERROR LOCALBOOT 0
  32
  33 In addition, PXE booted Nodes rely on the PXE server passing the mac address
  34 of the pxe interface to the kernel.  This is provided by using the IPAPPEND 2
  35 parameter as follows:
  36
  37 DEFAULT pxeboot
  38 TIMEOUT 20
  39 PROMPT 0
  40 LABEL pxeboot
  41       KERNEL vmlinuz0
  42       IPAPPEND 2
  43       APPEND rootflags=loop initrd=initrd0.img root=/ovirt-node-image.iso rootfstype=auto ro liveimg check rootfstype=iso9660 elevator=deadline
  44 ONERROR LOCALBOOT 0
  45