My activities New request

contact atmail support

PH: +61 (7) 5357-6605

support@atmail.com

Follow

Atmail 7.X to Atmail 7.7.1 WebMail Client Only Upgrade

Stewart -

PROBLEM
I'm not sure how to upgrade my Atmail WebMail Client Only install.

ENVIRONMENT

  • Webmail Only Installations: Version 7.0 > 7.7.1

CAUSE
Atmail needs to be upgraded to the latest version.

RESOLUTION

This tutorial will demonstrate how to upgrade an existing Atmail Client 7.X installation to the latest Atmail version.

Atmail 7.2+
PHP 5.3+ required for 7.2.0+

In these instructions, replace [version] with your current version of Atmail. These are generic instructions to upgrade any previous release of Atmail 7.X to Atmail 7.7.1 Version. The process is designed to be as straightforward as possible, and uses the WebAdmin interface to help simplify the upgrade.

Pre-upgrade

Backup

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

Upgrading will remove any personal customizations and your custom branding.

mysqldump -u root -p atmail7webmail > /var/www/html/atmail/atmail7[version]-backup.sql
tar cfvz atmail7[version]-backup.tgz /var/www/html/atmail /etc/httpd/conf/httpd.conf

Where /var/www/html/ is the base document root of your server where your installation of Atmail is located.

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) must be backed up. The upgrade process will overwrite any modifications, and these must be merged in after the upgrade.

Download

Download the latest atmail 7.7.1 tarball via the following URL.

http://download.atmail.com/old-releases/atmail.7.7.1.webmail.tgz

Upgrade

Step 1

Extract the .tgz out into the directory for Atmail.

cd /var/www/html/
tar xfvz atmail7.webmail.tgz -C /var/www/html/

Where /var/www/html/ is the base document root of your server where your installation of Atmail is located.

Step 2

You will now need to give Atmail correct permissions.

chown -R [web-server-user] /var/www/html/atmail/
cd /var/www/html/atmail/
find . -name .htaccess -exec chown root:root {} \;
find . -name .htaccess -exec chmod 644 {} \;

Where [web-server-user] is the user that runs Apache. Where /var/www/html/ is the base document root of your server where your installation of Atmail is located.

Step 3

Atmail 7.5.x
If you are upgrading from 7.5.x please ensure that you have cleared cached minify files from your installation.

To find minify cache path:

Config file: /library/Composer/vendor/mrclay/minify/min/config.php
Param: $min_cachePath
Default value: $min_cachePath = sys_get_temp_dir(); // usually /tmp

Once cache directory is found, remove all files where the file names starts with "minify_"

Step 4

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/atmail/index.php/admin/

Where server.com/atmail/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.

Step 4

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 /var/www/html/atmail/
php ./utilities/upgrade/client-update.php

Step 5

Congratulations, the upgrade is now complete. You can now reload the Webmail interface of Atmail and begin using the Atmail 7 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 Atmail 7 version.

Troubleshooting

Apache 2.4+

Add a Directory directive as follows (/etc/httpd/conf.d/atmail-webmail.conf):

<Directory "/var/www/html/webmail/">
Options ExecCGI FollowSymLinks
AllowOverride All
Order allow,deny
Allow from all
Require all granted
</Directory>

Where /var/www/html/webmail/ is the path to your webmail only installation.

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.0.0.12032; Login to your Atmail database and execute the following command.

mysql> update Config set keyValue = "7.0.0.12032" 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.

cd /var/www/html/atmail/
php ./utilities/upgrade/client-update.php
Have more questions? Submit a request

Comments