help centre
For more info visit status.atmail.com

How can we help?


Search our knowledge base for answers to
common questions and latest updates.



My activities New request

Follow

Atmail 6.X to Atmail 7.7.1 WebMail Client Only Upgrade

Stewart -

PROBLEM
I'm not sure how to upgrade my Atmail 6 WebMail Client only install to Atmail 7.

ENVIRONMENT

  • Webmail Only Installations: Version 6.0 > 7.7.1

CAUSE
Atmail needs to be upgraded to the latest version.

RESOLUTION

This guide will take you through the steps to upgrade Atmail 6 WebMail Client to Atmail 7.7.1 WebMail Client.

Atmail 7.2+
PHP 5.3+ required for 7.2.0+

Backup
Note: The upgrade and migration scripts have been used for production systems and considered stable.

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

Upgrading will remove your custom branding.

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

Preparing MySQL

Most Atmail 6 installations use the database name 'atmail6'.Do the following to transfer data from database 'atmail6' into a new database 'atmail7'.

Dump the MySQL database

mysqldump -u root -p atmail6 > /var/www/html/atmail/atmail6-dump.sql

Import the Atmail database.

Log into MySQL and create new database 'atmail7' to insert the dump into.

mysql -u root -p
mysql> create database atmail7;

Log out of MySQL and import the dump into the 'atmail7' database.

mysql -u root -p atmail7 < /var/www/html/atmail/atmail6-dump.sql

Update Atmail MySQL Settings

Open and edit /var/www/html/atmail/config/dbconfig.ini

Locate:

database.params.dbname   = "atmail6"

Change To:

database.params.dbname   = "atmail7"

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 /download-location/
tar xfvz atmail7.webmail.tgz -C /var/www/html/

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 {} \;

Step 3

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.


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 latest Atmail 7 version.

If you pick up any bugs or other problems with the new update please create a support ticket at:

http://atmail.com/ticketing/ - Login with your existing account and password.

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

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

Licensing Issues

No available license seats. Please add more seats.

Clients upgrading from Atmail 6 to Atmail 7 may experience this error message upon installation:
No available license seats. Please add more seats.

If you experience this issue, please go to WebAdmin > Settings > Global Settings, and click on Save Settings (as per the following screenshot):

Doing so should fix the issue.

Error: License Invalid or No License Installed.

Clients upgrading from Atmail 6 to Atmail 7 may experience this error message upon installation:

Error: License Invalid or No License Installed.

If you experience this issue, please the following command via MySQL:

mysql>select licenseType from Groups;

Example.

mysql> select licenseType from Groups;
 
+-------------+
| licenseType |
+-------------+
|           0 |
|           0 |
|           0 |
|           0 |
|           0 |
|           5 |
|           0 |
+-------------+

Note that '0' is not a vaild licenseType. To resolve, update licenseType to match your license.

Example.

mysql> update Groups set licenseType='5';
Have more questions? Submit a request

Comments


Contact our support team


+61 (7) 5357 6605       support@atmail.com