Upgrade to Atmail 7.8.0+ - Server + WebMail

PROBLEM
I want to upgrade my atmail Server + WebMail installation to 7.8.0+.

ENVIRONMENT

• On-Premise Server + WebMail Installations: Version 7.7.1
• To upgrade to atmail 7.8.0+, please first upgrade to atmail 7.7.1.

CAUSE
Atmail needs to be upgraded to the latest version.

RESOLUTION

⚠ Atmail 7.8.0+
PHP 5.4+ required for 7.8.0+

Backup

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

mysqldump -u root -p atmail7 > /usr/local/atmail/atmail-7[version]-backup.sql

tar cfvz atmail-7[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 customization's to Atmail (PHP, HTML, Anti-Spam and MTA-related code changes) must be backed up. The upgrade process will overwrite any modifications, and these must be merged in after the upgrade.

Upgrade atmail 7.7.1 > atmail 7.8.0+

1. Download the latest atmail tarball via your customer portal downloads section.
   

   https://atmail.com/portal2/

2. Extract the software out into the directory for Atmail
   

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

3. You will now need to give Atmail correct permissions.
   

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

4. RPM/Appliance Install ONLY:
   

   mv /usr/local/atmail/mailserver/bin/atmail-update-version /usr/local/atmail/mailserver/bin/atmail-update-version.off

5. Visit the WebAdmin of Atmail and use the Update software link. This will guide you through the web-based upgrade utility for the database schema updates and config changes:
   
   e.g http://server.com/mail/index.php/admin/
   
   Where server.com/mail/index.php is the URL of the Atmail software on your server. Login to Web Administration using your admin username/password, then click the License tab > Update software.
   
   
   Note: Available Version will indicate the version available on your server. Please ensure steps previous steps are completed before moving to the WebAdmin upgrade.
   
   
6. Depending on the software update, additional 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

Troubleshooting

CentOS 7 - Postfix

If you are planning to use your newly installed RHEL/CentOS 7 to run atmail Server + WebMail edition,  you will need to remove the Postifx MTA daemon, that is installed by default on RHEL/CentOS 7.

As you will notice, Postfix is started and listens on localhost on port 25. Proceed with Postfix MTA service removal by issuing the following commands.

# systemctl stop postfix
# systemctl disable postfix
# yum remove postfix

Force Re-Run Upgrade

If you run into any troubles with the upgrade you may need to re-run the upgrade process.

Assuming that your last version was 7.7.1; Login to your Atmail database and execute the following command.

mysql> update Config set keyValue = "7.7.1" where keyName = "version";

This will fool the WebAdmin update scripts and enable re-running the sql schema updates via the WebAdmin > License > Update Software.

Following the success of the WebAdmin update, please then execute the server-update.php file as the update page will instruct you.

php server-update.php 7.7.1