Upgrade Carbonio and Ubuntu

Upgrade Carbonio and Ubuntu#

In order to upgrade from a Carbonio 24.1 on Ubuntu 20.04 to Carbonio 24.3.0 on Ubuntu 22.04 you need to follow the procedure in this section. Please read carefully the whole page before starting the upgrade.

The procedure will require to reboot the nodes and therefore a downtime of the Carbonio infrastructure must be planned.

The procedure is divided into phases:

  1. upgrade PostgreSQL from 12 to 16

  2. upgrade Carbonio to 24.3.0

  3. upgrade Ubuntu LTS from 20.04 to 22.04 (Jammy Jellifish)

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

Phase 2#

This phase is the same as a normal upgrade, so please refer to Section Carbonio Upgrade from 24.1 to 24.3.0.

Phase 3#

This phase requires to upgrade the Ubuntu 20.04 distribution to 22.04: please refer to the Ubuntu’s upstream documentation.

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

  1. contains the word jammy

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

You can now stop the Carbonio services, update the package list, and the packages itself with these commands

# su - zextras -c "zmcontrol stop"
# apt update && apt upgrade

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"