The ironic.drivers.modules.pxe Module

PXE Boot Interface

class ironic.drivers.modules.pxe.PXEBoot[source]

Bases: ironic.drivers.base.BootInterface

clean_up_instance(*args, **kwargs)[source]

Cleans up the boot of instance.

This method cleans up the environment that was setup for booting the instance. It unlinks the instance kernel/ramdisk in node’s directory in tftproot and removes the PXE config.

Parameters:task – a task from TaskManager.
Returns:None
clean_up_ramdisk(*args, **kwargs)[source]

Cleans up the boot of ironic ramdisk.

This method cleans up the PXE environment that was setup for booting the deploy ramdisk. It unlinks the deploy kernel/ramdisk in the node’s directory in tftproot and removes it’s PXE config.

Parameters:task – a task from TaskManager.
Returns:None
get_properties()[source]

Return the properties of the interface.

Returns:dictionary of <property name>:<property description> entries.
prepare_instance(*args, **kwargs)[source]

Prepares the boot of instance.

This method prepares the boot of the instance after reading relevant information from the node’s instance_info. In case of netboot, it updates the dhcp entries and switches the PXE config. In case of localboot, it cleans up the PXE config.

Parameters:task – a task from TaskManager.
Returns:None
prepare_ramdisk(*args, **kwargs)[source]

Prepares the boot of Ironic ramdisk using PXE.

This method prepares the boot of the deploy kernel/ramdisk after reading relevant information from the node’s driver_info and instance_info.

Parameters:
  • task – a task from TaskManager.
  • ramdisk_params – the parameters to be passed to the ramdisk. pxe driver passes these parameters as kernel command-line arguments.
Returns:

None

Raises:

MissingParameterValue, if some information is missing in node’s driver_info or instance_info.

Raises:

InvalidParameterValue, if some information provided is invalid.

Raises:

IronicException, if some power or set boot boot device operation failed on the node.

validate(*args, **kwargs)[source]

Validate the PXE-specific info for booting deploy/instance images.

This method validates the PXE-specific info for booting the ramdisk and instance on the node. If invalid, raises an exception; otherwise returns None.

Parameters:task – a task from TaskManager.
Returns:None
Raises:InvalidParameterValue, if some parameters are invalid.
Raises:MissingParameterValue, if some required parameters are missing.
class ironic.drivers.modules.pxe.TFTPImageCache[source]

Bases: ironic.drivers.modules.image_cache.ImageCache