Skip to content

bios-configure

Configure BIOS settings on a system

This task is responsible for setting BIOS settings on a machine. The bios-target-configuration parameter on the machine must be populated with a sane set of settings for the machine, and the bios-driver parameter must be set to one appropriate to the system. This task takes several steps:

  1. If the bios-skip-config param is true, the task exits succesfully.
  2. The task compares the current settings to the ones from bios-target-configuration If the values that need to be changed are the same as the ones listed in bios-last-attempted-configuration, then the task prints out an error message indicating that the bios configuration process cannot make progress and exits with failure.
  3. The bios-last-attempted-configuration param is set to the settings from bios-target-configuration that need to be changed.
  4. The settings from bios-target-configuration are applied to the machine, and the task indicates success, failure, or a need to reboot depending on what the underlying tooling returns.

When the task runs in a context, such as for an out-of-band driver, the context runner cannot reboot the machine. If any settings were applied, the task sets bios-oob-reboot-required to true instead, and the bios-oob-reboot task run on the machine afterwards performs the reboot.

Objects that Reference bios-configure

Objects used by bios-configure