Backup

Before doing any upgrade create a backup of all the system settings with the Backup Manager (Admin → Backup). The backup contains all the relevant system settings like users, certificates, keys, MTA settings etc.

Upgrade procedure

The actual upgrade procedure depends on how CipherMail is installed.

Tip

After an upgrade, restart your browser or clean the browser cache to make sure that updated CSS files are being reloaded.

Virtual Appliance

If you are using the CipherMail Professional or Enterprise edition Pro/Ent only, CipherMail will provide an executable which will upgrade the gateway in place.

Users of the community edition should install the new version of the virtual appliance and restore backup.

Note

The backup does not contain the SSL/TLS certificate. The SSL/TLS certificate should be manually restored if you imported a new virtual appliance.

Using the packages

If the gateway has been installed with one of the provided packages (.deb or .rpm) the gateway can be upgraded in-place by installing the new packages.

Upgrade Ubuntu/Debian

Stop services

sudo service postfix stop
sudo service djigzo stop
sudo service tomcat8 stop

Update packages

Note

If CipherMail is configured for MySQL or Oracle, skip installing the djigzo-postgres package

sudo dpkg -i djigzo_?.?.?-?_all.deb
sudo dpkg -i djigzo-postgres_?.?.?-?_all.deb
sudo dpkg -i djigzo-web_?.?.?-?_all.deb

Clear Tomcat cache

After an upgrade, the Tomcat cache file should be cleared.

Note

Tomcat caches certain files. The cache is not cleared even after a restart of Tomcat. To make sure that files from the previous version of CipherMail do not interfere with files from the newly installed version, you are strongly advised to clear the Tomcat cache.

sudo rm -r /var/cache/tomcat[5,6,7,8]/Catalina/localhost/ciphermail
sudo rm -r /var/cache/tomcat[5,6,7,8]/Catalina/localhost/web

Restart services

sudo service tomcat8 restart
sudo service djigzo restart
sudo service postfix restart

Upgrade RedHat/CentOS

Stop services

service postfix stop
service djigzo stop
service tomcat stop

Update packages

Note

If CipherMail is configured for MySQL or Oracle, skip installing the djigzo-postgres package

rpm -U djigzo-?.?.?-?.noarch.rpm
rpm -U djigzo-postgres-?.?.?-?.noarch.rpm
rpm -U djigzo-web-?.?.?-?.noarch.rpm

Clear Tomcat cache

After an upgrade, the Tomcat cache file should be cleared.

Note

Tomcat caches certain files. The cache is not cleared even after a restart of Tomcat. To make sure that files from the previous version of CipherMail do not interfere with files from the newly installed version, you are strongly advised to clear the Tomcat cache.

rm -rf /var/cache/tomcat/work/Catalina/localhost/ciphermail
rm -rf /var/cache/tomcat/work/Catalina/localhost/web

Restart services

service tomcat restart
service djigzo restart
service postfix restart

Upgrade SLES 12

Stop services

service postfix stop
service djigzo stop
service tomcat stop

Update packages

Note

If CipherMail is configured for MySQL or Oracle, skip installing the djigzo-postgres package

rpm -U djigzo-?.?.?-?.SUSE.noarch.rpm
rpm -U djigzo-postgres-?.?.?-?.SUSE.noarch.rpm
rpm -U djigzo-web-?.?.?-?.noarch.rpm

Clear Tomcat cache

After an upgrade, the Tomcat cache file should be cleared.

Note

Tomcat caches certain files. The cache is not cleared even after a restart of Tomcat. To make sure that files from the previous version of CipherMail do not interfere with files from the newly installed version, you are strongly advised to clear the Tomcat cache.

rm -r /srv/tomcat/webapps/ciphermail
rm -r /srv/tomcat/webapps/web

Restart services

service tomcat restart
service djigzo restart
service postfix restart