From Previous Version

From Previous Version#

This section guides you in the upgrade from Carbonio CE 24.12, regardless of any specific patch numbers, to the latest 25.3.0.

Requirements & Preliminaries#

The upgrade to 25.6.0 may include some additional procedure that impacts the following Components, packages, or third-party software, which require some manual interaction before, during, or after the procedure. If you already have implemented them, please skip to the next section.

Operating system

Carbonio CE can be installed on Ubuntu 22.04 LTS, Ubuntu 24.04 LTS, RHEL 8, and RHEL 9. If you plan to upgrade both the OS and Carbonio CE, please refer to Section OS Upgrade.

Warning

The 25.6.0 release of Carbonio CE dropped support for Ubuntu 20.04 LTS, which is EOL since May 2025.

We strongly recommend upgrading to Ubuntu 22.04 LTS or even Ubuntu 24.04 LTS to ensure continued compatibility and support. .

PostgreSQL 16 support

Carbonio CE no longer supports PostgreSQL 12, which must be upgraded to version 16 before upgrading Carbonio CE to 25.6.0. Check section Upgrade to PostgreSQL 16 for directions.

Additionally, please check Section Known Issues (Current Release) under Troubleshooting Carbonio CE before starting the upgrade. There you find a list of manual activities that might be required during or after the completion of the upgrade procedure that impact third-party software or new packages.

Checklist#

A Chats-related package changed name in this release: carbonio-message-dispatcher becomes carbonio-message-dispatcher-ce. You need to manually remove the former and install the new one. This task is included in the upgrade procedure, so simply follow the instructions.

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.

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.

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 Component 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 Component, 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.

# apt update

# dnf check-update
Step 3. Install new package

On the Node installing the Chats Component, remove package carbonio-message-dispatcher and install carbonio-message-dispatcher-ce.

# apt remove carbonio-message-dispatcher
# apt install carbonio-message-dispatcher-ce
Step 4. Upgrade Node

Update package list and install upgrades.

# apt upgrade

# dnf upgrade --best --allowerasing
Step 5. (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 6. Register upgraded packages to Carbonio Mesh
# pending-setups -a
Step 7. Migration of new Dispatcher package

To complete the installation of the new carbonio-message-dispatcher-ce package, execute these commands

# PGPASSWORD=$DB_ADM_PWD carbonio-message-dispatcher-migration \
  carbonio_adm 127.78.0.10 20000

Restart the service

# systemctl restart carbonio-message-dispatcher
Step 8. Reboot

Once the upgrade has completed successfully, run command:

# reboot
Contents