Upgrade to Carbonio 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 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 upgrade procedure is carried out along with the system upgrade.
The upgrade procedure can be carried out manually or using Ansible. The latter procedure works even if you installed Carbonio manually, provided you fill in the inventory file.
In both cases, the procedure will upgrade any version of Carbonio 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 to the latest version of Carbonio (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, you must update Carbonio 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, resulting in Carbonio release installed on Ubuntu 24.04
Upgrade Carbonio to the latest available version for your current OS release
Upgrade the operating system and update its repositories
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
Update the PostgreSQL and Carbonio repositories to match the new OS version. This step ensures the repositories point to the correct package sources after the OS upgrade.
Upgrade the Carbonio packages again using the new repositories. This final upgrade aligns all Carbonio components with the updated OS environment.
RHEL 8 to RHEL 9#
The in-place upgrade of RHEL OS with an existing Carbonio 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.
Deploy a new Node running RHEL 9
Migrate data and services from the existing RHEL 8 Node to the new RHEL 9 Node
Once all services and data have been successfully moved, decommission the old RHEL 8 Node, i.e., remove it from the infrastructure