Upgrade From 24.9

Upgrade From 24.9#

This section guides you in the upgrade from Carbonio 24.9, regardless of any specific patch numbers, e.g. 24.9.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 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, 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.

DB Connector Role

The DB Connector Role is no longer available, therefore you need to move some of the packages to the Database Role. The procedure to carry out this task can be found in Section Pgpool Removal.

Upgrade Procedure#

The upgrade procedures requires that you log in to each node of your Carbonio 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 before starting the upgrade. Check also Section Requirements & Preliminaries for a list of major upgrades that impact Roles and third-party software.

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.

Remember to start the upgrade from the Node featuring the Directory Server, 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

Update package list and install upgrades.

# apt update && apt dist-upgrade

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

After the latest packages have been installed, make sure that you do not have unused packages still installed on your system.

# 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. 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

Note

After the upgrade has successfully completed, we strongly suggest to carry out the tasks described in Troubleshooting sections: change Directory Server credentials and empty the pre-auth keys.