Skip to content

Rescuing a server

This guide will walk you through the required steps to access a server in rescue mode when you need to.

You can use rescue mode to access the server’s operating system disk to fix a corrupted file system, reset access credentials on the server, and do other emergency recovery tasks.

Prerequisites

You need to have previously created a server that you now wish to rescue. Additionally, if you prefer to work with the OpenStack CLI, then make sure to properly enable it first.

Initiating the rescue

Navigate to the server list.

The left hand side navigation panel, with the word "Servers"
highlighted.

Find the server you want to rescue in the list, and on the right-hand side, click on its menu button.

An orange circle with three white
dots.

Click on Rescue Server.

A list of server actions, with the line "Rescue Server"
highlighted.

Once selected, the rescue dialog appears. Leave the default option, Use System Rescue Image.

Click No to cancel or Rescue to proceed.

About to rescue a server, showing details with the default option
"Use System Rescue Image".

When a server has been switched to rescue mode, its status icon appears with an exclamation mark:

Exclamation mark on server icon showing the server on "rescue
mode".

You must first select a system rescue image from the available images:

$ openstack image list --tag system-rescue
+--------------------------------------+---------------+--------+
| ID                                   | Name          | Status |
+--------------------------------------+---------------+--------+
| cb2217f3-1ca7-4440-b10e-df7ff2d92cae | system-rescue | active |
+--------------------------------------+---------------+--------+

To start the server using the system rescue image, use the following command, substituting the correct ID for the system-rescue image in your Cleura Cloud region:

openstack --os-compute-api-version 2.87 \
  server rescue \
  --image cb2217f3-1ca7-4440-b10e-df7ff2d92cae <server_id>

While the rescue is ongoing, the server should have the OS-EXT-STS:vm_state of rescued and the status of RESCUE.

$ openstack server show -v OS-EXT-STS:vm_state -c status <server_id>
+---------------------+---------+
| Field               | Value   |
+---------------------+---------+
| OS-EXT-STS:vm_state | rescued |
| status              | RESCUE  |
+---------------------+---------+

Accessing the server in rescue mode

You can now proceed to accessing the remote console of your server, as you would with any other newly launched server.

Please refer to the System Rescue documentation documentation for details on the available tools and features bundled with System Rescue.