diff options
| author | Lucas Alvares Gomes <lucasagomes@gmail.com> | 2016-09-08 12:39:31 +0100 |
|---|---|---|
| committer | Lucas Alvares Gomes <lucasagomes@gmail.com> | 2016-09-19 11:39:33 +0000 |
| commit | 5110a6558149e922911055808e9210cc476579eb (patch) | |
| tree | aabb5fc561086ff311001b9f6ba2774efc830957 /doc | |
| parent | 53f8b173ae91b141bae1b5dbe872baedc45f7866 (diff) | |
| download | ironic-5110a6558149e922911055808e9210cc476579eb.tar.gz | |
Grub2 by default for PXE + UEFI
This patch is changing the default bootloader for PXE + UEFI to Grub2.
Prior to this patch Elilo was the default but, Elilo is no longer
maintained with the last release dating 2014.
Ironic should have sane defaults therefore we should not rely on an
unmaintained project.
Change-Id: Ib34fcbd37e4698bf272582c96b1540b511b5a892
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/source/deploy/install-guide.rst | 56 |
1 files changed, 32 insertions, 24 deletions
diff --git a/doc/source/deploy/install-guide.rst b/doc/source/deploy/install-guide.rst index 1ed12d8b8..6b1d10d95 100644 --- a/doc/source/deploy/install-guide.rst +++ b/doc/source/deploy/install-guide.rst @@ -968,17 +968,7 @@ PXE UEFI setup If you want to deploy on a UEFI supported bare metal, perform these additional steps on the ironic conductor node to configure the PXE UEFI environment. -#. Download and untar the elilo bootloader version >= 3.16 from - http://sourceforge.net/projects/elilo/:: - - sudo tar zxvf elilo-3.16-all.tar.gz - -#. Copy the elilo boot loader image to ``/tftpboot`` directory:: - - sudo cp ./elilo-3.16-x86_64.efi /tftpboot/elilo.efi - -#. Grub2 is an alternate UEFI bootloader supported in Bare Metal service. - Install grub2 and shim packages:: +#. Install Grub2 and shim packages:: Ubuntu: (14.04LTS and later) sudo apt-get install grub-efi-amd64-signed shim-signed @@ -1028,18 +1018,6 @@ steps on the ironic conductor node to configure the PXE UEFI environment. sudo chmod 644 $GRUB_DIR/grub.cfg -#. Update bootfile and template file configuration parameters for UEFI PXE boot - in the Bare Metal Service's configuration file (/etc/ironic/ironic.conf):: - - [pxe] - - # Bootfile DHCP parameter for UEFI boot mode. (string value) - uefi_pxe_bootfile_name=bootx64.efi - - # Template file for PXE configuration for UEFI boot loader. - # (string value) - uefi_pxe_config_template=$pybasedir/drivers/modules/pxe_grub_config.template - #. Update the bare metal node with ``boot_mode`` capability in node's properties field:: @@ -1052,7 +1030,37 @@ steps on the ironic conductor node to configure the PXE UEFI environment. boot device on the bare metal node. So this step is not required for ``pxe_ilo`` driver. -For more information on configuring boot modes, refer boot_mode_support_. +.. note:: + For more information on configuring boot modes, see boot_mode_support_. + + +Elilo: an alternative to Grub2 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Elilo is a UEFI bootloader. It is an alternative to Grub2, although it +isn't recommended since it is not being supported. + +#. Download and untar the elilo bootloader version >= 3.16 from + http://sourceforge.net/projects/elilo/:: + + sudo tar zxvf elilo-3.16-all.tar.gz + +#. Copy the elilo boot loader image to ``/tftpboot`` directory:: + + sudo cp ./elilo-3.16-x86_64.efi /tftpboot/elilo.efi + +#. Update bootfile and template file configuration parameters for UEFI + PXE boot in the Bare Metal Service's configuration file + (/etc/ironic/ironic.conf):: + + [pxe] + + # Bootfile DHCP parameter for UEFI boot mode. (string value) + uefi_pxe_bootfile_name=elilo.efi + + # Template file for PXE configuration for UEFI boot loader. + # (string value) + uefi_pxe_config_template=$pybasedir/drivers/modules/elilo_efi_pxe_config.template iPXE setup |