Appendix D. Alternative Boot Modes


The default boot mode for nodes is BIOS over iPXE. The following sections outline some alternative boot modes for the director to use when provisioning and inspecting nodes.

D.1. Standard PXE

The iPXE boot process uses HTTP to boot the introspection and deployment images. Older systems might only support a standard PXE boot, which boots over TFTP.

To change from iPXE to PXE, edit the undercloud.conf file on the director host and set ipxe_enabled to False:

Copy to Clipboard Toggle word wrap
ipxe_enabled = False

Save this file and run the undercloud installation:

Copy to Clipboard Toggle word wrap
$ openstack undercloud install

For more information on this process, see the article "Changing from iPXE to PXE in Red Hat OpenStack Platform director".

D.2. UEFI Boot Mode

The default boot mode is the legacy BIOS mode. Newer systems might require UEFI boot mode instead of the legacy BIOS mode. In this situation, set the following in your undercloud.conf file:

Copy to Clipboard Toggle word wrap
ipxe_enabled = True
inspection_enable_uefi = True

Save this file and run the undercloud installation:

Copy to Clipboard Toggle word wrap
$ openstack undercloud install

Set the boot mode to uefi for each registered node. For example, to add or replace the existing boot_mode parameters in the capabilities property:

Copy to Clipboard Toggle word wrap
$ NODE=<NODE NAME OR ID> ; openstack baremetal node set --property capabilities="boot_mode:uefi,$(openstack baremetal node show $NODE -f json -c properties | jq -r .properties.capabilities | sed "s/boot_mode:[^,]*,//g")" $NODE
Note

Check that you have retained the profile and boot_option capabilities with this command.

In addition, set the boot mode to uefi for each flavor. For example:

Copy to Clipboard Toggle word wrap
$ openstack flavor set --property capabilities:boot_mode='uefi' control
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.