OS Upgrade#
The procedure must be carried out on each Node, starting from the one on which the Directory Server Role is installed, and it will require to reboot the Node and therefore a downtime of the Carbonio infrastructure must be planned. Please read carefully the whole section before starting the upgrade.
The procedure is divided into phases:
upgrade PostgreSQL from 12 to 16 (you can skip it if you already upgraded)
manual upgrade Carbonio to 24.9.1
upgrade Ubuntu LTS from 20.04 to 22.04 (Jammy Jellifish) or RHEL 8 to RHEL 9
upgrade Carbonio's packages to match the correct repository
complete the upgrade procedure
Phase 1#
Upgrade to PostgreSQL 16 is mandatory, because Ubuntu 22.04 does not support the current PostgreSQL 12 installed on Carbonio. Directions to upgrade PostgreSQL can be found in Section PostgreSQL 16 Upgrade.
Hint
PostgreSQL 12 will be supported only until 24 November 2024, so if you did not already upgrade to 16, you should do so as soon as possible.
Phase 2#
This phase is the same as a normal upgrade, so please refer to Section Manual Upgrade.
Phase 3#
This phase requires to upgrade the Ubuntu 20.04 distribution to 22.04 or the RHEL 8 to RHEL 9 please refer to the Ubuntu and Red Hat upstream documentations.
Note
If you upgrade to Ubuntu 22 and use the Carbonio Monitoring role, please make sure to change the Grafana repository.
Phase 4#
Once you successfully carried out the first three phases, you can proceed to update the Carbonio packages to match the distribution. This phase requires some manual command to be executed.
During the Ubuntu upgrade, the file
/etc/apt/sources.list.d/zextras.list
will be
modified. You need to make sure that it contains only the
correct repository, that is, the line defining the repository
contains the word jammy
is not commented, i.e., it does not start with a
#
sign
During the RHEL upgrade, the file
/etc/yum.repos.d/zextras.repo
will be modified. You need
to make sure that it contains only the correct repository, that
is, the line defining the repository is:
baseurl=https://repo.zextras.io/release/rhel9
Then update the package list, and the packages themselves with these commands
# apt update && apt dist-upgrade
# dnf upgrade –best –allowerasing
Finally, reboot the Node.
# reboot