Upgrade to Carbonio CE 25.12.0

Upgrade to Carbonio CE 25.12.0#

This section contains the manual upgrade procedures to the latest Carbonio release, from the latest 25.9 and from older versions, the changelogs of recent and older releases, and any security advice, if present.

Carbonio CE does not have any installer: whenever new versions are released, the Zextras repositories are updated and packages are available for installation along with the other system updates. Therefore, the Carbonio CE upgrade procedure is carried out along with the system upgrade.

The procedure will upgrade any version of Carbonio CE to the latest available at the moment you start the procedure. In other words, the starting version is not important: upgrading from 25.1, 25.3 or 25.6 will bring Carbonio CE to the latest version of Carbonio CE (at the time of writing, 25.12.0).

Before starting an upgrade procedure, it is strongly suggested to make a snapshot of the Nodes and a backup of the data.

Operating System Upgrade#

In case you need to upgrade the OS along with Carbonio CE, you must update Carbonio CE and all repositories in a specific order to ensure compatibility and avoid package dependency errors.

Warning

In release 25.12.0 it is not possible to upgrade directly from RHEL 8 to RHEL 9.

Ubuntu 22.04 to 24.04#

The following procedure allows to upgrade both the OS and Carbonio CE, resulting in Carbonio CE release installed on Ubuntu 24.04

  1. Upgrade Carbonio CE to the latest available version for your current OS release

  2. Upgrade the operating system and update its repositories

  3. Perform the OS upgrade (for example, from Ubuntu 22.04 to 24.04 or from RHEL 8 to 9), then update all system packages to the latest versions

  4. Update the PostgreSQL and Carbonio CE repositories to match the new OS version. This step ensures the repositories point to the correct package sources after the OS upgrade.

  5. Upgrade the Carbonio CE packages again using the new repositories. This final upgrade aligns all Carbonio CE components with the updated OS environment.

RHEL 8 to RHEL 9#

The in-place upgrade of RHEL OS with an existing Carbonio CE Node is not supported. Attempting to upgrade the underlying OS directly will result in an unsupported and potentially unstable environment.

Currently, the only supported procedure to upgrade RHEL 8 to RHEL 9 is the following.

  1. Deploy a new Node running RHEL 9

  2. Migrate data and services from the existing RHEL 8 Node to the new RHEL 9 Node

  3. Once all services and data have been successfully moved, decommission the old RHEL 8 Node, i.e., remove it from the infrastructure