Upgrade for Carbonio CE
The Zextras repositories are updated whenever new versions are published, and packages are then made available for installation with other system updates. Carbonio CE does not have an installer. Since there are only a few commands that must be run on each Node, whether it is the (single) Node in a Single-Server installation or all the Nodes in a Multi-Server installation, the upgrading procedure is often a very rapid activity.
The technique for upgrading consists of a preparatory step followed by the correct upgrade, which is the same for each Node. The successful update will always move Carbonio CE to the most recent version available, which is presently 23.6.0, regardless of the version that is already installed.
Some manual step may be necessary, depending on the updated packages and the version you are upgrading from. Before beginning the update, please carefully read section update Checklist to see whether any further tasks are required.
In addition, if the upgrade involves third-party software, incompatibilities might occur, necessitating the completion of certain extra manual processes. There is advice to prevent or resolve these problems in the section below under Troubleshooting.
The following roles or packages are affected by this update, and they involve some manual work.
- the package called
. You could get into a library clash only on RHEL 8. Please go to the Troubleshooting section in this situation.
The Directory Server’s LDAP data is backed up as a first step. The node having the Directory Server Role installed, in our case in a Multi-Server installation, should run the tasks listed below.
- Create an LDAP database dump, particularly if the update involves the Directory Server. The command can be used to do this (as the
should be copied as a backup and kept in a secure location.
Remember to start from the node hosting the Directory Server (SRV2 in our Six Nodes Scenario), then install everything else in the same order, if you’re using a multi-server setup.
Step 1. Stop services
Step 2. Clean cached package list and information
Step 3. Update package list and install upgrades
You can run across the following problem when installing
on RHEL 8-based distributions:
You must carry out the instruction and heed the counsel in the last line
You can pick up the upgrade again when the package has been installed.
Missing carbonio-docs-editor user
On RHEL 8-based Multi-Server installations only, you may find the following error in all AppServers that do not have* the
In these cases you need to open the
, which is the script that fails, with a text editor and find the lines:
The workaround is to comment out these four lines, by prepending a
to each line, that will therefore become:
Then, run the script again.