The Zextras repositories are updated whenever new versions are released, and packages are then made available for installation with other system updates. Carbonio does not have an installer. As a result, upgrading is typically a relatively short process that only requires a few commands to be run on each Node.
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 to the most recent version available, which is now 23.9.0, regardless of the version that is already installed.
There could be some manual steps needed, 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.
Additionally, compatibility issues that need additional manual procedures may occur if the upgrade contains software from a third party. The information to resolve these problems is in the section below under Troubleshooting.
The following are impacted by this update items or roles that need for manual intervention during the process.
the VideoServer Carbonio. When prompted to replace the configuration file during the upgrade, select N to prefer to preserve the previous version in order to avoid any service interruptions.
the package called carbonio-docs-core. You could run into a little issue with RHEL 8 only, and the section Troubleshooting has the answer.
The Directory Server’s LDAP data is backed up as a first step. The node having the Directory Server Role installed, in our case SRV2 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 zextras user).
- File /opt/zextras/conf/localconfig.xml should be copied as a backup and kept in a secure location.
Keep in mind to update the nodes in the same sequence they were installed, starting with the one hosting the Directory Server (SRV2 in our Five Nodes Scenario).
In this area, you’ll discover fixes for various potential upgrade-related errors.
Carbonio-docs-editor’s installation was unsuccessful
You could have the following problem when installing Carbonio-docs-Editor 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.
Carbonio-docs-editor user not found
You can see the following problem in all AppServers that do not have the carbonio-docs-editor package installed on RHEL 8-based Multi-Server setups only.
In these circumstances, you must use a text editor to locate the following lines in the script that fails, /opt/zextras/libexec/zmfixperms:
The fix is to comment out these four lines by adding a # to the beginning of each line, which will result in:
Next, execute the script once again.