Starting your Dedicated Server in rescue mode

This page describes how to start your Dedicated Server in rescue mode through the Action panel in the Customer Portal.

Rescue mode

You can reboot your server in rescue mode if your operating system fails to boot or if you do not have access to your server anymore. Rescue mode, or LiveOS is a Linux environment equipped with tools to support accessing your data. You can try to resolve the issue or back up data before performing a reinstallation. Please see Resolving server issues in Rescue Mode for support with troubleshooting.

How to start rebooting a Dedicated Server in rescue mode

Perform the following steps to start your server in rescue mode:

1. In the Leaseweb Customer Portal click Dedicated Server.
   • The Dedicated Servers overview page displays.
2. Click the ID of the server that you want to boot into rescue mode.
   • The Server Details page displays.
     
3. Under Action, click Rescue Mode.
   
4. Select the rescue image you want to boot the server with, GRML, CentOS 7 or FreeBSD.

5. Optionally, you can:
   • Provide an SSH public key in the OpenSSH format. This key is placed in the /root/.ssh/authorized_keys file.
   • Uncheck the “Power cycle the server” checkbox. By default, a server is power cycled to start rescue mode. If you want to reboot the server yourself, the power cycle can be skipped.
   • Provide a callback URL. When the rescue mode has launched successfully or an issue is encountered, an HTTP POST request is made to the callback URL endpoint, providing a JSON object with details of the rescue mode in the body.
     • Example:  

{
    "bareMetalId": "70522",
    "createdAt": "2017-06-23T08:11:38+0000",
    "flow": "tasks",
    "isRunning": true,
    "node": "AA:BB:CC:DD:EE:FF!0123456789",
    "payload": {
        "jobType": "rescueMode",
        "powerCycle": true,
        "serverId": 70522
    },
    "progress": {
        "canceled": 0,
        "expired": 0,
        "failed": 0,
        "finished": 0,
        "inprogress": 1,
        "pending": 0,
        "percentage": 0,
        "total": 1,
        "waiting": 0
    },
    "status": "ACTIVE",
    "tasks": [
        {
            "description": "send_rescue_mode_email",
            "errorMessage": null,
            "flow": "tasks",
            "onError": "break",
            "status": "INPROGRESS",
            "statusTimestamps": {
                "INPROGRESS": "2017-06-23T08:11:38+00:00",
                "PENDING": "2017-06-23T08:11:38+00:00",
                "WAITING": "2017-06-23T08:11:38+00:00"
            },
            "uuid": "2c215097-7da8-45fc-b08b-3a293050b8f6"
        }
    ],
    "type": "rescueMode",
    "updatedAt": "2017-06-23T08:11:38+0000",
    "uuid": "8be35658-251e-461a-bdd9-755150f44873"
} 

6. To start the rescue mode, click the Launch button.
7. When the rescue mode has launched successfully, you are returned to the Server Details page. 
   • A confirmation message is shown at the top right of the page.