Upgrade From 24.7 or 24.9#

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 upgrade procedure is usually a very quick activity, carried out by means of a few commands to be executed on each Node, be it the (single) Node in a Single-Server installation, or all the Nodes in a Multi-Server installation.

The upgrade procedure is the same, regardless of the currently installed version of Carbonio CE. The difference is that if you upgrade from 24.7.1 or 24.9.0, you usually do not need to carry out any other task manually, while if you upgrade from any older version, you will probably need to run some tasks or commands before, during, or after the upgrade procedure.

Before proceeding to the upgrade, if you upgrade from 24.7.1 or 24.9.0, please read carefully section Upgrade from 24.9.0; otherwise, please read section Upgrade from Older Versions.

Moreover, check Sections Known Issues (Current Release) and Known Issues (Older Releases) to check for possible issue that you may encounter during the upgrade.

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.

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

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. Verify correct installation of Directory Server package

If you are upgrading the Mesh and Directory Node, make sure that the carbonio-message-broker package is installed.

This situation arises because that package was initially required by the Work Stream Collaboration (Chats) (WSC) Role, but now is used by the whole Carbonio CE. So, if you never installed WSC, make sure you have this package on the correct Mesh and Directory Node.

# dpkg -l carbonio-message-broker

The output should be (version may vary):

ii  carbonio-message-broker 0.2.0-1jammy amd64   Carbonio message broker
# rpm -q carbonio-message-broker

The output should be (version may vary):

carbonio-message-broker-0.2.0-1.el8.x86_64

If it is not installed, install it manually

# apt install carbonio-message-broker
# dnf install carbonio-message-broker
Step 5. Register upgraded packages to Carbonio Mesh
# pending-setups -a
Step 6. Reboot

Once the upgrade has completed successfully, run command:

# reboot

Upgrade from 24.9.0#

If you upgrade from 24.9.0, there is no know issue that impacts either the upgrade process to Carbonio CE 24.9.1 or the Carbonio CE operations afterwards.

Requirements & Preliminaries#

This upgrade procedure requires that PostgreSQL 16 be installed. If you did not yet upgrade it, please refer to Section PostgreSQL 16 Upgrade.

Upgrade from Older Versions#

If you plan to upgrade from a version older than 24.9.0, you may encounter issues or need to carry out tasks or command that are reported in Section Known Issues (Older Releases).

Requirements & Preliminaries#

This upgrade procedure requires that PostgreSQL 16 be installed. If you did not yet upgrade it, please refer to Section PostgreSQL 16 Upgrade.