Skip to main content

Operating system upgrade

Performing an operating system upgrade can be easily done by yourself with the help of the provided instructions and upgrade scripts. Below we provide you with all the necessary information for such an upgrade.

Please never upgrade your operating system manually, always use the instructions listed below.


Workflow

An operating system upgrade on a KeyHelp system always follows the following procedure.

First, the appropriate upgrade script for your deployed operating system must be downloaded to your server. This script will guide you through the upgrade and perform all the necessary tasks for you.
After the tasks have been processed, your server uses the new operating system version.

Depending on the operating system, installed software, available bandwidth and performance, such an update can take one to several hours, while the services on your server are only partially accessible in the process.


Important notes

  1. After you have started the upgrade script and confirmed the start of the work with [ENTER], all described steps must be executed. If you cancel the running process, any changes already made must be undone manually.

  2. A running upgrade process should always be monitored. Please keep the terminal window open for the duration of the upgrade. You should consider running the upgrade with the screen command to prevent the SSH session from being accidentally terminated.

  3. Be sure to perform a backup before beginning the operating system upgrade and familiarize yourself with restoring it in the event of a failed upgrade.

  4. The /etc/apt/sources.list package source list is overwritten during the upgrade. If you have configured your own package sources, you may need to reconfigure them after the upgrade.


Available guides for Debian

All available guides for the Debian operating system can be found at Upgrade guides for Debian.


Available guides for Ubuntu

All available guides for the Ubuntu operating system can be found at Upgrade guides for Ubuntu.