Update Ubuntu Bionic (18.04) to Ubuntu Focal (20.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 Bionic System to Ubuntu Focal.
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 where found, remove tham 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
Disable MySQL Query Cache¶
The MySQL Query Cache got removed with MySQL 8.0. Therefore it is important to make sure that the Query Cache feature is disabled in your MySQL configuration.
sed -i 's/^[ ]*query_cache/#query_cache/g' /etc/mysql/mysql.conf.d/*.cnf
Stop PHP-FPM service¶
systemctl stop php7.2-fpm.service
Change package sources¶
Now the package sources can be changed to the next Ubuntu release
sed -i 's/bionic/focal/g' /etc/apt/*.list
sed -i 's/bionic/focal/g' /etc/apt/*/*.list
Upgrade¶
Now the actual upgrade from Ubuntu 18.04 to 20.04 starts.
apt update && apt -y full-upgrade
During the upgrade, the system may ask you various questions. You should answer them as follows.
libc6¶
Any queries regarding libc6 must be answered with Yes.
MySQL¶
Most likely, restarting the MySQL server will fail. This can be ignored.
openssh-server¶
Keep the current configuration of your OpenSSH server
phpMyAdmin¶
If you have phpMyAdmin installed on your system, answer this question with Yes
Sub-process error¶
It can happen that the installation aborts with error E: Sub-process /usr/bin/dpkg returned an exit code (1).
This can be ignored.
Update PHP¶
Now all PHP packages will be updated.
systemctl stop php7.2-fpm.service
dpkg -l | awk '/php7.2/ { print $2}' | sed 's/php7.2/php7.4/' | xargs apt-get install -y
dpkg -l | awk '/php7.2/ { print $2}' | xargs apt-get purge -y
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 recommended to complete the update
reboot