Files
ironic-python-agent/doc/source/admin/rescue.rst
Julia Kreger f9ae319fdd docs: remove tinyipa references
We have started down the path of eradicating tinyipa usage and testing
because it was bifrucating our contirbutor resources and focus now that
we have also been able to fix some of the CI jobs to be a bit more
scalable.

This does mean we're doing more with dib based images and they are larger,
but we're willing ot pay that tax as a project for consistency and
CI job stability.

Change-Id: I8f96d106a85f6ab4493785e88955196da08af8e9
Signed-off-by: Julia Kreger <juliaashleykreger@gmail.com>
2025-07-09 09:53:19 -07:00

1.3 KiB

Rescue mode

Overview

Rescue mode is a feature that can be used to boot a ramdisk for a tenant in case the machine is otherwise inaccessible. For example, if there's a disk failure that prevents access to another operating system, rescue mode can be used to diagnose and fix the problem.

Support in ironic-python-agent images

Rescue is initiated when ironic-conductor sends the finalize_rescue command to ironic-python-agent. A user rescue is created with a password provided as an argument to this command. DHCP is then configured to facilitate network connectivity, thus enabling a user to login to the machine in rescue mode.

Warning

Rescue mode exposes the contents of the ramdisk to the tenant. Ensure that any rescue image you build does not contain secrets (e.g. sensitive clean steps, proprietary firmware blobs).

The below has information about supported images that may be built to use rescue mode.

DIB

The DIB image supports rescue mode when used with DHCP tenant networks.

After the finalize_rescue command completes, DHCP will be configured on all network interfaces, and a rescue user will be created with the specified rescue_password.