1. Atmail 5 to Atmail 6 Webmail Client Upgrade

This document will provide a tutorial on upgrading from Atmail 5 to Atmail 6 webmail client with user.

1.1 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:

  tar cfvz atmail5-backup.tgz /var/www/html/atmail /etc/httpd/conf/httpd.conf

1.2 Pre-upgrade Requirements

SSH/TELNET access to host machine.

Required Information

Some required information about your Atmail 5 installation can be found in the Config.php file:

./webmail/libs/Atmail/Config.php

The following fields will contain everything you need:

sql_host - Atmail 5 sql database host
sql_user/sql_pass - Atmail 5 sql username and password
sql_table - Atmail 5 sql database name

Other information are used in the Atmail 6 installation are required:

Atmail 6 database name

1.3 Upgrade

Before proceeding, please make sure you have all required information

Atmail 5.X migration

The migration scripts can upgrade any Atmail 5.X installation.

Ensure latest database version

You must ensure that the Atmail 5 database is any 5.X version. We must extract the upgrade script and support code from the Atmail 6 tarball

tar xzf atmail6.webmail.tgz atmail/webmail/utilities/migration/a5-upgrade.php

You must find the Config.php file for your current installation, then you may run the supplied upgrade script which will upgrade your current Atmail 5 installation to the latest schema.

php atmail/webmail/utilities/migration/a5-upgrade.php atmail/webmail/libs/Atmail/Config.php

Move Atmail 5 installation

In your Atmail5 installation root directory (for the following examples we assume the default installation folder):

  cd /var/www/html/atmail/
  mv webmail webmail.a5
  mv README README.a5
  rm -rf tmp

Note : It is very important that you leave the users directory intact.

Install Atmail 6

Please follow the Installation Guide for Atmail 6.

Make sure you create a new database for Atmail 6 during installation. Your existing Atmail 5 database is required to put data into your new Atmail 6 database. DO NOT use your Atmail 5 database for Atmail 6.

Upgrade Atmail 5 to Atmail 6

Using the provided scripts we can now migrate user accounts and settings from the current installation of Atmail 5 to your new installation of Atmail 6.

Find the utility directory for your Atmail 6 installation.

  cd /var/www/html/atmail/webmail/utilities/migration

To perform the user migration:

php migrate-a5-a6.php [atmail 5 table] [atmail 6 table] [atmail 5 sql user] [atmail 5 sql pass] [atmail 5 sql host]

To perform the configuration migration:

php migrate-a5-config.php [atmail 6 table] [atmail 6 sql user] [atmail 6 sql pass] [atmail 6 sql host] [Config.php (optional)]

If your Atmail installation is in a different location then you will need to specify the location of your Config.php

To perform the calendar data migration:

php migrate-calendar-a5-a6.php [sql host] [sql table] [sql_user] [sql_pass]

Your Atmail 6 installation will now have the previous Atmail 5 installation user accounts and settings.

1.4 Example Upgrade

Atmail 6 tarball downloaded to ~/, previous installation lives in /usr/local/atmail.

tar xzf atmail6.webmail.tgz atmail/webmail/utilities/migration/a5-upgrade.php
php atmail/webmail/utilities/migration/a5-upgrade.php atmail/webmail/libs/Atmail/Config.php
	[Preform web-base upgrade]
	cd /var/www/html/atmail
	mv webmail webmail.a5
	rm -rf tmp
	tar xvzf atmail6.webmail.tgz -C /var/www/html/
	chown -R apache /var/www/html/atmail/
	[Preform web installer http://localhost/atmail/webmail/]
	cd /var/www/html/atmail/webmail/utilities/migration
	php migrate-a5-a6.php atmail562 atmail6 mysql_user mysql_pass localhost
	php migrate-a5-config.php atmail6 mysql_user mysql_pass localhost
	php migrate-calendar-a5-a6.php localhost atmail6 mysql_user mysql_pass

1.5 Upgrade Issues

Please see Migration Issues for any known upgrade or migration issues.