How can we help?


Server + WebMail Multi-Server Upgrade Guide

Stewart -

I'm not sure how to upgrade my Atmail Server + WebMail MultiServer installation.


  • On-Premise Server + WebMail MultiServer Installations: Current Version

Atmail needs to be upgraded.



This document details the upgrade process for multiserver installations following the format of the Atmail Multiserver Installation guides. Given the architectural differences compared to single-server implementations, the upgrade process is marginally different.

Server Terms

For purposes of clarity, the servers will be designated as follows:

FRONT1 - Frontend 1, Web/SMTP/POP/IMAP services
FRONT2 - Frontend 2, Web/SMTP/POP/IMAP services
STORAGE1 - Storage 1 - optional, if using external GlusterFS storage
STORAGE2 - Storage 2 - optional, if using external GlusterFS storage

Upgrade Preparation

Backup + Download

Before proceeding it is strongly recommended that you make a backup of your current Atmail installation.

mysqldump -u root -p atmail7 > /usr/local/atmail/atmail7[version]-backup.sql
tar cfvz atmail7[version]-backup.tgz /usr/local/atmail /etc/httpd/conf/httpd.conf /etc/init.d/atmailserver

This is required before you upgrade in case you need to roll-back any changes, do not skip this step.

Any customizations to Atmail (PHP, HTML, MTA-related code changes) must be backed up. The upgrade process will overwrite any modifications, and these must be merged in after the upgrade.

First signup as an Atmail evaluation user or download the software from the Atmail client portal. Move this file into your working directory (which for this document, we'll point to as /root/):

mv atmail7.mailserver.tgz /root/

Upgrade Process

Untar the new Atmail package over your installation:

tar xvfz atmail7.mailserver.tgz -C /usr/local/

After the untar is finished, assign the correct permissions for the Atmail directory:

chown -R atmail:atmail /usr/local/atmail/;
cd /usr/local/atmail/webmail/;
find . -name .htaccess -exec chown root:root {} \;
find . -name .htaccess -exec chmod 644 {} \;

Login to your WebAdmin interface. The WebAdmin panel will guide you through the web-based upgrade utility for the database schema updates and config changes:

Where is the URL of the Atmail software on your server. Once logged in, click on License > Update Software.

You may be prompted to run an additional command via the terminal. Packages may need to be re-installed or re-compiled if you are using the Email Server version of Atmail. If prompted during the Web Admin upgrade, run the additional upgrade utility from a command-line:

cd /usr/local/atmail/
php server-update.php

Upgrade Synchronization

Once the upgrade is complete on FRONT1, you will need to apply the changes to FRONT2. Login to FRONT1 via SSH, and execute the following command:

rsync -avr e ssh --exclude="tmp/" --exclude="log/" --exclude="config/dbconfig.ini" /usr/local/atmail/webmail/ root@FRONT2:/usr/local/atmail/webmail/
rsync -avr e ssh --exclude="spool/" /usr/local/atmail/mailserver/ root@FRONT2:/usr/local/atmail/mailserver/
rsync -avr e ssh  /usr/local/atmail/server-update.php root@FRONT2:/usr/local/atmail/server-update.php
rsync -avr e ssh  /usr/local/atmail/server_source/ root@FRONT2:/usr/local/atmail/server_source/

Login to FRONT2 using SSH. Login to MySQL, and update the cli.version value with your previous value. For this guide, we will use Atmail

mysql -u root -p [atmaildb]
> update Config set keyValue="" where keyName="cli.version";

Once this is done, you can execute the server-update.php command to update the rest:

cd /usr/local/atmail/
php server-update.php

Congratulations, the upgrade is now complete. You can now reload the WebMail interface of Atmail and begin using the latest version.

If you've made any customizations to the HTML templates, images, or source-code, these changes will need to be copied back in after the upgrade. We recommend using the “diff” command-line utility to compare any local customizations to the previous Atmail version.


Contact our support team

+61 (7) 5357 6605