From Previous Version

From Previous Version#

This section guides you in the upgrade from Carbonio CE 25.12, regardless of any specific patch numbers, to the latest 26.3.0.

Requirements & Preliminaries#

  1. To prevent any data loss, it is suggested to make a backup before upgrading.

  2. During the packages installation, you will be prompted to replace the localconfig.xml file. The correct answer is NO, which is also the default answer: you need to keep the existing file, otherwise several critical configuration parameters will be lost, causing the upgrade process to fail. Replacing the file will lead to service disruption and requires a long, manual recovery.

Upgrade Nodes#

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 Component 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

  3. It is necessary that all services, especially OpenLDAP, be running during the whole procedure

    zextras$ zmcontrol status

    zextras$ zmcontrol status

    To see the status of only a service, use the new systemd commands that replace the zmcontrol commands (see Carbonio Systemd Targets).

    To see the status of only a service, use the new systemd commands that replace the zmcontrol commands (see Carbonio Systemd Targets).

    If in the output some service appears as not running, start it.

Step 1. Clean package list

Clean cached package list, metadata, and information.

# apt clean

# dnf clean all

# apt clean

# dnf clean all
Step 2. Update list of packages

Update package list.

# apt update

# dnf check-update

# apt update

# dnf check-update
Step 3. Upgrade Node

Install upgrades.

Danger

Remember to keep the localconfig.xml file, answering NO when asked to. Selecting YES can overwrite your configuration and break the installation.

Recovery: If the upgrade breaks the system due to selecting YES, restore the backup of localconfig.xml to its original location and rerun the upgrade to recover the installation.

# apt full-upgrade

# dnf upgrade --best --allowerasing

# apt full-upgrade

# dnf upgrade --best --allowerasing
Step 4. Install new memcached package

Install the carbonio-memcached package, which is part of the Proxy component and is required by the latest version of Carbonio CE.

# apt install carbonio-memcached

# dnf install carbonio-memcached

# apt install carbonio-memcached

# dnf install carbonio-memcached
Step 5. (Optional) Remove unused packages

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

# apt autoremove

# dnf autoremove
Step 6. Register upgraded packages to Carbonio Mesh
# pending-setups -a
Step 7. Reboot

Once the upgrade has completed successfully, run command:

# reboot