My activities New request

contact atmail support

PH: +61 (7) 5357-6605

support@atmail.com

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