openstack/ironic
Code Issues Proposed changes
Files
31ac1b72f2e0d84f11feb9942ad1cf715a3e2bc8
ironic/install-guide/source/include/boot-mode.rst
Dmitry Tantsur 10decb88bb Refactor install-guide: driver and hardware types configuration 
* Move PXE and iPXE configuration to a separate document
* Move IPMI and iSCSI configuration to a separate document
* Move bits mostly dealing with node-update to "advanced" section
* Write detailed documentation on drivers, hardware types and interfaces
* Drop outdated information, like custom DHCP file

Change-Id: I6dfc8842fb262285308578f82fab701bd29289fa
Related-Bug: #1524745
2017-05-17 10:43:58 +02:00

1.8 KiB
Raw Blame History

Boot mode support

The following drivers support setting of boot mode (Legacy BIOS or UEFI).

  • pxe_ipmitool

The boot modes can be configured in Bare Metal service in the following way:

  • When no boot mode setting is provided, these drivers default the boot_mode to Legacy BIOS.

  • Only one boot mode (either uefi or bios) can be configured for the node.

  • If the operator wants a node to boot always in uefi mode or bios mode, then they may use capabilities parameter within properties field of an bare metal node. The operator must manually set the appropriate boot mode on the bare metal node.

    To configure a node in uefi mode, then set capabilities as below:

    ironic node-update <node-uuid> add properties/capabilities='boot_mode:uefi'

    Nodes having boot_mode set to uefi may be requested by adding an extra_spec to the Compute service flavor:

    nova flavor-key ironic-test-3 set capabilities:boot_mode="uefi"
nova boot --flavor ironic-test-3 --image test-image instance-1

    If capabilities is used in extra_spec as above, nova scheduler (ComputeCapabilitiesFilter) will match only bare metal nodes which have the boot_mode set appropriately in properties/capabilities. It will filter out rest of the nodes.

    The above facility for matching in the Compute service can be used in heterogeneous environments where there is a mix of uefi and bios machines, and operator wants to provide a choice to the user regarding boot modes. If the flavor doesn't contain boot_mode and boot_mode is configured for bare metal nodes, then nova scheduler will consider all nodes and user may get either bios or uefi machine.