label_alt_logo
2024-09-16

Upgrade from Ubuntu 22.04 to Ubuntu 24.04

by Alexander Mahr

Since version 24.2, KeyHelp also supports the operating system Ubuntu 24.04 "Noble Numbat".

Are you running KeyHelp on a server with Ubuntu 22.04 and would now like to take advantage of the optimized Ubuntu 24.04?
With this guide, we give you the opportunity to upgrade the software by yourself and provide you with the required upgrade application and detailed instructions.
Please do not hesitate to contact us if you have any questions or require assistance.




Such instructions are also available for the older operating system versions of Debian and Ubuntu.
Further information can be found here.

ATTENTION: After you have started the upgrade application and confirmed the start of the upgrade with [ENTER], all the steps described here must be completed. If you cancel the current process, any changes already made must be undone manually.

ATTENTION: An ongoing upgrade process should always be monitored. Please keep the terminal window open for the duration of the upgrade. You should consider running the upgrade using the screen command to prevent the SSH session from being accidentally terminated.

ATTENTION: Although extensively tested, a previous backup of the server should always be performed.

ATTENTION: In the course of the upgrade, the previous email protection system, consisting of the components Amavis, SpamAssassin and OpenDKIM, will be replaced by the modern system Rspamd. Please check the proper functioning of the email system after the upgrade.

The DKIM keys of the previous system are seamlessly imported into the new system, so external DNS administrations do not need to be updated in this regard.


 

Upgrade guide

1.)
Start the upgrade application with the following command:

wget --no-check-certificate https://install.keyhelp.de/scripts/upgrade_operating_system.sh -O upgrade_operating_system.sh && bash upgrade_operating_system.sh

During the upgrade, you may be asked to restart your server and run the upgrade application again.
Please always use this command to start the upgrade application.

2.)
You are now in the start screen of the application.
After you hit [ENTER], the upgrade application performs all necessary tasks in preparation of the upgrade.
Additional server reboots may be required, perform them when prompted and restart the upgrade application.

3.)
The program flow is transferred to the Ubuntu application do-release-upgrade. Please follow the instructions of this program.
On questions about Should system config files be overwritten? answer with Keep the local version currently installed.

After running the application, the system prompts you to reboot the server. Please perform the reboot.

4.)
After restarting the server, restart the upgrade application with the command mentioned in section 1.).

5.)
Confirm the continuation of the upgrade with [ENTER].
The upgrade application will now configure the installed services.
Once this process is complete, confirm the restart of the server.

The upgrade is now complete and your server is ready for use.
Congratulations, you now use KeyHelp with Ubuntu 24.04 "Noble Numbat"!