Manual Upgrade

Manual Upgrade#

The manual upgrade procedures requires that you log in to each node of your Carbonio infrastructure and execute some command, 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.

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

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 4. Register upgraded packages to Carbonio Mesh
# pending-setups -a
Step 5. Reboot

Once the upgrade has completed successfully, run command:

# reboot

Requirements & Preliminaries#

The upgrade to 24.9.0 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 can be upgraded from version 12 to version 16. This step is mandatory if you also plan to upgrade from Ubuntu 20.04 to Ubuntu 22.04, because version 12 is no longer available on Ubuntu 22.04. Please follow the instructions in section PostgreSQL 16 Upgrade.

Warning

PostgreSQL 12 will reach the End Of Life on 14th November 2024 end of the year, so make sure to plan its upgrade before that date!

Contents