WebMail Pro 8 documentation

Migration from v7 - console tool

Introduction

We provide a script for migration from v7 of the product. There are cases, however, when using the script is not an option - for example, if you need the script to be run from console rather than web browser.

Performing WebMail v7 backup

In this documentation page, we'll describe the use of console-based migration script on cPanel installation of WebMail, but it'll work for other cases as well.

If you're not using the cPanel installation, you can skip this section and proceed to the next one.

Since installing version 8 would require removing v7 first, you need to copy the directory and the database first.

We recommend to copy WebMail v7 installation from /usr/local/cpanel/base/3rdparty/afterlogic to a directory called, for example, /usr/local/cpanel/base/3rdparty/afterlogic-v7.

To create a copy of the database used by v7, run the following commands:

mysqldump cp_aftlgc > v7.sql
mysqladmin create cp7aftlgc
mysql cp7aftlgc < v7.sql

Now it's safe to remove v7 installation and deploy v8 one.

Preparing the migration

This step assumes you already have v8 installation deployed and v7 database and filesystem backed up. For non-cPanel case, make sure v7 backup directory can be accessed by webserver.

You'll need to download migration script, unzip it and place into dev/ subdirectory of WebMail v8 installation.

Within the script, provide full path to v7 installation:

$sP7ProductPath = "PATH_TO_YOUR_WEBMAIL_V7_INSTALLATION";

Open data/settings/settings.xml file of v7 installation and make sure correct v7 database name is supplied (cp7aftlgc in cPanel case), and DBLogin / DBPassword are correct (in cPanel case, copy them from data/settings/config.json file of v8 installation).

Performing the migration

Once the configuration is performed, you can go to dev/ directory and run the migration script:

cd /usr/local/cpanel/base/3rdparty/afterlogic/dev
php ./migrate_console.php