AI-assisted content notice: This documentation was created with support from artificial intelligence and has been reviewed by humans for accuracy.
Update Ubuntu Focal (20.04) to Ubuntu Jammy (22.04)¶
Backup
Before you start, make sure you have a working backup of your system!
Please make sure to run all commands as root user.
In order to always be able to use the latest version of openITCOCKPIT, it is important to keep the underlying operating system up to date. You can use this guide to upgrade your Ubuntu Focal System to Ubuntu Jammy.
End of life
Ubuntu 20.04 (Focal) reached its end of life in May 2025 and no longer receives security updates. Use this guide only to migrate an existing installation - a fresh installation of a supported release is usually the better choice.
Requirements¶
- openITCOCKPIT in version 4.x
- No packages containing
lxd
Removal of all lxd packages¶
If you have lxd packages installed on your system, they must be removed first. You can check this with the command
apt list --installed | grep lxd
If any lxd packages were found, remove them like so
apt -y remove lxd*
Installation of all updates¶
Before you start updating Ubuntu, please make sure that all available updates have been installed.
apt update && apt -y full-upgrade
Stop PHP-FPM service¶
systemctl stop php7.4-fpm.service
Detect openITCOCKPIT packages¶
First all installed packages of openITCOCKPIT are determined and saved in the variable openitcockpit_upd.
openitcockpit_upd=$(apt-mark showmanual | grep openitcockpit | xargs echo)" "$(apt-mark showauto | grep openitcockpit | xargs echo)
Change package sources¶
Now the package sources can be changed to the next Ubuntu release
sed -i 's/focal/jammy/g' /etc/apt/*.list
sed -i 's/focal/jammy/g' /etc/apt/*/*.list
Upgrade¶
Now the actual upgrade from Ubuntu 20.04 to 22.04 starts.
apt update && apt -y full-upgrade $openitcockpit_upd php-json php-curl php-gearman php-xml apache2-
Update configuration¶
In the last step, all configuration files are updated and regenerated if necessary.
openITCOCKPIT Master¶
If you are running the update on an openITCOCKPIT master system, use the following command
openitcockpit-update --cc
openITCOCKPIT Satellite¶
For openITCOCKPIT Satellite execute
/opt/openitc/frontend/UPDATE.sh
A restart of the system is required to complete the update
reboot