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#
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.
-
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. 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.
Clean cached package list, metadata, and information.
# apt clean
# dnf clean all
Update package list and install upgrades.
# apt update && apt upgrade
# dnf upgrade --best --allowerasing
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
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
# pending-setups -a
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.