commit	4c06cf6711e28fef2f3c172d040e4311e19663fc	[log] [tgz]
author	Zack Williams <zdw@opennetworking.org>	Mon Feb 28 17:42:27 2022 -0700
committer	Zack Williams <zdw@opennetworking.org>	Mon Feb 28 17:42:27 2022 -0700
tree	0f4e59936309623f3dd576cd10d24d746746a35f
parent	92f3c20b9a7e3324a7b7823cfd2cdf4fdf2c2583 [diff]

tree: 0f4e59936309623f3dd576cd10d24d746746a35f

README.md

pxeboot

Configures PXE and iPXE related boot scripts and images on an web server.

See the ipxe-build repo for building iPXE payload images.

The iPXE boot.ipxe script:

Has a menu that reports system information and network status
Gives options for installation (interactive and autoinstall) and diagnostic tools (currently: memtest)
- Alternate options to help debug or supply nonfree firmware
List of images in the iPXE menu is specified by the pxeboot_boot_images variable for customizing which tools are available.
By default, continues boot normally after 10 seconds

Also populates the kernel, initrd, and other files needed to network boot.

For fully automated installation, separate Debian/Ubuntu preseed files are created based on the serial number of the device (and possibly other criteria like MAC address in the future). Hosts are defined in the pxeboot_hosts list, which has these options:

domain: Domain extension for the host
hostname: Hostname of the system
serial: Serial number, must match the SMBIOS supplied serial for server to boot properly.
iface: (optional) Network interface to use when setting up the system. This is primarily to work around this bug which can cause the wrong interface to be selected in the install process: https://bugs.launchpad.net/ubuntu/+source/netcfg/+bug/713385

Documentation of the preseed process can be found in these links:

Contents of the preseed file: https://help.ubuntu.com/18.04/installation-guide/amd64/apbs04.html
All preseed configuration options: https://preseed.debian.net/debian-preseed/
iPXE docs on preseed files and kernel arguments: https://ipxe.org/appnote/debian_preseed

Some systems may need additional firmware to boot properly (for example, to initialize network cards), which can be supplied during boot as another cpio file: https://wiki.debian.org/DebianInstaller/NetbootFirmware

Additional references:

https://wiki.debian.org/DebianInstaller/Preseed https://wiki.ubuntu.com/UEFI/PXE-netboot-install https://help.ubuntu.com/lts/installation-guide/example-preseed.txt

iPXE script examples: https://github.com/netbootxyz/netboot.xyz

Example Playbook

- hosts: all
  vars:
    pxeboot_hosts:
      - {domain: 'example.com', hostname: 'server1', serial: 'abc123'}
      - {domain: 'example.com', hostname: 'server2', serial: 'abc123', iface: 'eno2'}
  roles:
    - pxeboot

pxeboot

Example Playbook

License and Author