Upgrading Your Operating System

Learn the steps to upgrade an end-of-life operating system to a new version.

Danger

WARNING: As with any major release upgrade of an operating system there is a risk of failure, data loss, or broken software configuration. Therefore, OVHcloud strongly recommends backing up your instance and conducting extensive testing on your applications to ensure they work on the new operating system version before following this tutorial.

Info

To avoid the problems mentioned above, installing a new server with the new operating system you are upgrading to and migrating the data instead is recommended. You may still need to review differences in your application, but the operating system will likely have greater stability.

Requirements

root access to the server
backup must be taken before starting

Instructions

Tip

Click the tab for your operating system.

Debian

Ubuntu

Fedora

Before starting with the major release upgrade, make sure that you update to the latest versions of all packages installed on the current release:

$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get full-upgrade

Danger

WARNING: The following is an optional step. However, you must carefully review packages that are no longer needed on the system. Otherwise, the following command might break the system.

$ sudo apt-get --purge autoremove

There may have been some updates which may require a reboot and therefore we must reboot first before we start upgrading:

$ sudo systemctl reboot

After the reboot we will update the /etc/apt/sources.list to target the next release (in this case we go from Buster to Bullseye):

$ sudo cp -v /etc/apt/sources.list /root/
$ sudo cp -rv /etc/apt/sources.list.d/ /root/
$ sudo sed -i 's/buster/bullseye/g' /etc/apt/sources.list
$ sudo sed -i 's/bullseye\/updates/bullseye-security/g' /etc/apt/sources.list

Now that the latest release is set as target, perform the upgrade and finally initate a reboot:

Info

You may have popups asking you about restarting services. Answer them yes.

$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get full-upgrade
$ sudo systemctl reboot

Verify the upgrade has worked:

$ uname -r
$ lsb_release -a

Before starting with the major release upgrade, make sure that you update to the latest versions of all packages installed on the current release:

$ sudo apt-get update

Next, you must upgrade your installed packages to their latest versions:

$ sudo apt-get upgrade -y

Once it has finished, you are ready to do dist-upgrade which will perform further upgrades that may need to be done:

$ sudo apt-get dist-upgrade -y

Finally, you are now ready for the major release upgrade. Ubuntu is now providing a tool called "do-release-upgrade" which makes upgrading safer and easier. Let's start with the upgrade:

$ sudo do-release-upgrade

Follow the instructions which will mainly consist of confirming you wish to proceed with specific actions.

Please note:

You could be asked by the tool to restart your server first before doing the upgrade. To do this, just type "reboot" and press enter.
You will be advised that doing this over an SSH connection is not recommended. Since there is no physical access to the server, SSH is the primary way to access your server. Ubuntu will start a new SSH service on another port so that in case of failure you still have another access. Furthermore, you will still be able to access the server through the console if you are completely locked out by SSH.
During the upgrade, you may be asked to confirm the removal of packages that are no longer being supported. You need to double check this has no impact on your applications before continuing.

Once the upgrade has completed, the server will reboot itself and you will lose connection until it boots up again. Few minutes later you should be able to log in and see a message similar as the following (the version will be the next available version compared to your previous version):

$ Welcome to Ubuntu 18.04.5 LTS (GNU/Linux 4.15.0-147-generic x86_64)

Info

The new version will not be reflected on the OVHcloud Control Panel / API and on the Horizon / OpenStack API when you upgrade the operating system instead of reinstalling it.

Now verify if your applications are working as expected. In case there are issues, we recommend restoring your backup that was taken prior to the upgrade.

Before starting with the major release upgrade, you first need to ensure that you will update to the latest versions of all packages installed on the current release. Enter this command:

$ sudo dnf upgrade --refresh

Now reboot the server:

$ sudo reboot

Once the server is rebooted, install the upgrade package:

$ sudo dnf install dnf-plugin-system-upgrade

Now that you have the required package, you can perform the upgrade. System upgrades are only officially supported and tested over 2 releases at most (e.g. from 32 to 34). In this example we will upgrade from Fedora 32 to 33:

$ sudo dnf system-upgrade download --releasever=33
$ sudo dnf system-upgrade reboot

Once the version is downloaded and the upgrade process has been initiated, the server will reboot to complete the upgrade.
It may take a while before you an connect again to the server as the upgrade takes a while to be completed.

Verify if your applications are working as expected. In case there are issues, we recommend restoring your backup that was taken prior to the upgrade.

Info

If you encounter any issues, you may find answers to your questions on the Fedora Docs.

Go further

Browse all the Compute guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about Public Cloud Compute on the OVHcloud US website.