SIXTHSTAR CARBONIO UPGRADE
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 upgrade will always move Carbonio 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 upgraded 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.
Note
The only supported versions for upgrade are the three prior iterations. If you install Carbonio from an older version, you might need to complete additional steps to make sure it runs properly.
In addition, if the upgrade involves third-party software, incompatibilities could occur, necessitating the completion of some extra manual processes. There is advice to prevent or resolve these problems in the section below under Troubleshooting.
Improvement Checklist
Warning
The Single-Server installation of Carbonio is no longer supported as of version 23.6. To ensure that you can still utilise Carbonio effectively if you just have a single server installed, you must add a few Nodes and redistribute the roles among them.
The following roles or packages are affected by this upgrade, and they call for some manual input during the process.
- A video server called Carbonio. You must select to preserve the previous configuration file version in order to avoid any service interruptions during the upgrade. To do this, click N when prompted to replace the configuration file.
- Its called the Carbonio Preview. In this scenario, you must decide whether to change the outdated configuration file. As a result, when prompted to change the configuration file during the upgrade, Select Y.
- The main carbonio-docs package. You might run into a disagreement between libraries on RHEL 8 only. Please go to the section Troubleshooting in this situation.
It is advised to create a backup of each Node or to take a snapshot of each Node (if you are using a hypervisor) for increased security and to prevent any data loss.
Introductory tasks
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.
1.Create an LDAP database dump, particularly if the upgrade involves the Directory Server. The command can be used to accomplish this (as the zextras user).
zextras$ /opt/zextras/libexec/zmslapcat /tmpNote
Copy the dump to a secure location before saving it in the
/tmp/directory.Make a backup copy of file
/opt/zextras/conf/localconfig.xmland store it in a safe place
Upgrade Nodes
As the zextras user, run:
zextras$ zmcontrol stop# apt clean
# dnf clean all
# apt update && apt upgrade# dnf upgradeThis step must be performed exclusively on the DB Connection node.
Carbonio Advanced
# PGPASSWORD=DB_ADM_PWD carbonio-mailbox-db-bootstrap carbonio_adm 127.0.0.1
Carbonio Files
# PGPASSWORD=DB_ADM_PWD carbonio-files-db-bootstrap carbonio_adm 127.0.0.1
Carbonio Docs
# PGPASSWORD=DB_ADM_PWD carbonio-docs-connector-db-bootstrap c
# pending-setups -aOnce the upgrade has completed successfully, run command:
# rebootTroubleshooting
You can run into the following error when installing Carbonio-docs-Editor on Red Hat-based distributions:
Error: Problem: package carbonio-docs-core-22.05.12-1.el8.x86_64 requires harfbuzz-icu,
but none of the providers can be installed
- package carbonio-docs-core-22.05.12-1.el8.x86_64 requires libharfbuzz-icu.so.0()(64bit), but none of the providers can be installed
- package harfbuzz-icu-1.7.5-3.el8.x86_64 conflicts with harfbuzz
provided by harfbuzz-1.7.5-3.el8.x86_64
- cannot install the best candidate for the job
- problem with installed package harfbuzz-1.7.5-3.el8.x86_64
(try to add '--allowerasing' to command line to replace conflicting packages or '--skip-broken' to skip uninstallable packages or '--nobest' to use not only best candidate packages)
You need to follow the advice in the last line and execute the command
# dnf install harfbuzz-icu --allowerasing
After the package has been installed, you can resume the upgrade.