Upgrade From 24.12.0#

This section guides you in the upgrade from Carbonio CE 24.12.0 to the latest 24.12.1.

Requirements & Preliminaries#

The upgrade to 24.12.1 impacts the following Roles, packages, or third-party software, which require some manual interaction before, during, or after the procedure.

Operating system

Carbonio CE can be installed on Ubuntu 22.04 and RHEL 9 (BETA support) since version 24.5.0. If you plan to upgrade both the OS and Carbonio CE, please refer to Section OS Upgrade.

PostgreSQL 16 support

PostgreSQL must be upgraded from version 12 to version 16, because version 12 has reached the End Of Life on 14th November 2024 end of the year. Check section Upgrade to PostgreSQL 16 for directions.

Upgrade Procedure#

The upgrade procedures requires that you log in to each node of your Carbonio CE infrastructure and execute some command, then rebooting the Node as soon as you have successfully completed the procedure. Because you need to follow the output of the commands and make sure everything proceeds flawlessly, this procedure is suggested only if you want to have the control of all the steps.

Hint

For improved security, to prevent any data loss, it is suggested to make a backup or take a snapshot (if you are using an hypervisor) of each Node before upgrading.

We can not provide any estimate on the time required by the upgrade, because various factors may impact the duration, including the number of Nodes, their load, the speed of network connection, and so on.

In some cases, incompatibilities may seldom arise in the upgrade of third-party software, which may lead to some additional manual steps to be carried out, so please check Section Known Issues (Current Release) under Troubleshooting Carbonio CE before starting the upgrade. Check also Section Requirements & Preliminaries for a list of major upgrades that impact Roles and third-party software.

Upgrade Nodes#

Preliminary Tasks

As a preliminary task, we backup the LDAP data of the Directory Server. On a Multi-Server installation, execute the following commands on the Node with the Directory Server Role installed.

  1. Make a dump of the LDAP Database, especially if the upgrade includes the Directory Server. This can be done using the command (as the zextras user)

    zextras$ /opt/zextras/libexec/zmslapcat /tmp
    

    Note

    The dump will be saved in the /tmp/ directory, so make sure to copy it to a safe location.

  2. Make a backup copy of file /opt/zextras/conf/localconfig.xml and store it in a safe place

  3. It is necessary that all services, especially OpenLDAP, be running during the whole procedure

    zextras$ zmcontrol status
    
    zextras$ zmcontrol status
    

    Hint

    On RHEL 9, use the new systemd commands that replace the zmcontrol command (see the dedicated box).

    If in the output some service appears as not running, start it.

If you are on a Multi-Server, remember to start from the Node featuring the Directory Server Role, then all the other Nodes in the same order of installation.

Step 1. Clean package list

Clean cached package list, metadata, and information.

# apt clean
# dnf clean all
Step 2. Upgrade Node

Update package list and install upgrades.

# apt update && apt upgrade
# dnf upgrade --best --allowerasing
Step 3. (Optional) Remove unused packages

After the latest packages have been installed, you can remove unused packages still installed on your system. If unsure, skip this step.

# apt autoremove
# dnf autoremove
Step 4. Register upgraded packages to Carbonio Mesh
# pending-setups -a
Step 5. Reboot

Once the upgrade has completed successfully, run command:

# reboot

Note

After the upgrade has successfully completed, we strongly suggest to change Directory Server credentials and empty the pre-auth keys.