Overview
Please be aware that this feature is supported starting with the 9.4.2 release.
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
- In the puppet master server, open the
site.pp
file for editing. The default location is/etc/puppet/manifests/site.pp
. - 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, } }
- Save the file.
Upgrading the Kerio Connect Multi-Server
To upgrade to a newer version of Kerio Connect:
- Download a package and update the local Debian repository.
- 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
- Publish the package in the repository.
update-archive
- On the puppet master server, download the 64-bit Debian installation package of Kerio Connect.
- 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:
- Disable automatic updates following the same process.
- 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:
- Log in as the
root
user. - Update the package definitions:
apt-get update
- List the available versions of Kerio Connect:
apt-cache showpkg kerio-connect
- 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
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 => latest
is missing in /etc/puppet/manifests/site.pp
. The upgrade should be done manually.