Upgrade Carbonio CE and Operating System

Upgrade Carbonio CE and Operating System#

In order to upgrade from a Carbonio CE 24.3.0 on Ubuntu 20.04 (or RHEL 8) to Carbonio CE 24.5.0 on Ubuntu 22.04 (or RHEL 9) you need to follow the procedure in this section. Please read carefully the whole page before starting the 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 CE infrastructure must be planned.

The procedure is divided into phases:

  1. upgrade PostgreSQL from 12 to 16 (you can skip it if you already upgraded)

  2. upgrade Carbonio CE to 24.5.0

  3. upgrade Ubuntu LTS from 20.04 to 22.04 (Jammy Jellifish) or RHEL 8 to RHEL 9

  4. upgrade Carbonio CE's packages to match the correct repository

  5. 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 CE. Directions to upgrade PostgreSQL can be found in Section Upgrade to PostgreSQL 16.

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 Carbonio CE Upgrade from 24.3.0 to 24.5.0.

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. Please refer to Section GPG Key of Grafana in Ubuntu 22.04 for directions.

Phase 4#

Once you successfully carried out the first three phases, you can proceed to update the Carbonio CE 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

  1. contains the word jammy

  2. is not commented, i.e., it does not start with a # sign

During the RHAL 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

You can now stop the Carbonio CE services

# su - zextras -c "zmcontrol stop"

Finally update the package list, and the packages itself with these commands

# apt update && apt dist-upgrade

# dnf upgrade –best –allowerasing

Phase 5#

At the end of the upgrade you need to fix the permissions and start the services

# /opt/zextras/libexec/zmfixperms
# su - zextras -c "zmcontrol start"