Overview

This article covers the upgrade and downgrade process in the Kerio Connect Multi-Server, which can install Kerio Connect updates automatically.

Administrators can download the new version on the puppet master server, and it is automatically installed on the other servers. They can also use the puppet master server to upgrade or downgrade the servers in the Kerio Connect Multi-Server.

Prerequisites

This information is designed for Kerio Connect Multi-Server 9.

Process

Disabling Automatic Updates

1. In the puppet master server, open the site.pp file for editing. The default location is /etc/puppet/manifests/site.pp.
2. Add ensure => present to the role definitions for all server roles.
   
   Example:

   if $::system_role == 'backend' {
           class {'kerio_cloud::backend':
                   ensure => present,
           }
   }
   
   if $::system_role == 'instant-messaging' {
           class {'kerio_cloud::backend':
                   im_enabled => true,
                   ensure     => present,
           }
   }
   
   if $::system_role == 'frontend' {
           class { 'kerio_cloud::proxy':
                   ensure     => present,
           }
   }
   
   if $::system_role == 'directory' {
           class { 'kerio_cloud::directory':
                   ensure     => present,
           }
   }

3. Save the file.

Upgrading the Kerio Connect Multi-Server

To upgrade to a newer version of Kerio Connect: 

1. Download a package and update the local Debian repository.
   1. On the puppet master server, download the 64-bit Debian installation package of Kerio Connect.
      
      cd /var/packages/pool/non-free/ wget  {URL to 64-bit Kerio Connect Debian package}

      For example: cd /var/packages/pool/non-free/ wget http://cdn.kerio.com/dwn/connect/connect-9.2.11-4847/kerio-connect-9.2.11-4847-linux-amd64.deb

   2. Publish the package in the repository.
      update-archive
2. Perform the manual update. Run the following commands on a server where the update is intended (Directory, Backend, Front-end, IM):

• apt-get update
• apt-get install kerio-connect

All Kerio Connect servers are upgraded within approximately 30 minutes.

Downgrading the Kerio Connect Multi-Server

Note: To downgrade to an older version of Kerio Connect, you must first disable automatic downloads on the puppet master server. Once disabled, the required version can be installed on the other servers.

On the Puppet Master Server:

1. Disable automatic updates following the same process.
2. Place the 64-bit Debian installation package of Kerio Connect's desired version in the /var/packages/pool/non-free/ folder.

On Each Back-end, Front-end, Instant Messaging, and Directory Server:

1. Log in as the root user.
2. Update the package definitions:
   apt-get update
3. List the available versions of Kerio Connect:
   apt-cache showpkg kerio-connect
4. Run the install command with the version you want to downgrade to:
   apt-get install kerio-connect=<version>

   For example: apt-get install kerio-connect=8.5.0.4190-1

Back to top

Confirmation

If the process completes without errors, then the desired version has been successfully installed.

On the puppet master, when opening the site.pp file for editing under /etc/puppet/manifests/site.pp, ensure => present is still present within the role definitions for all server roles, which indicates that automatic updates are still disabled. 

• To enable the automatic updates again, add ensure => latest to the role definitions for all server roles.

Note: An automatic update is no longer the default behavior in 9.2.2 as ensure => latestis missing in /etc/puppet/manifests/site.pp. The upgrade should be done manually.

Back to top