WebMail Pro documentation

Migration from v7 to v8 - console tool

Starting 1 Dec 2023, this is no longer supported by Afterlogic, blank installation is strongly advised.
You can still migrate at your own risk, or request assistance in terms of Professional Services contract.
NB: This documentation page only applies to previous v8 of the product.

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.

Within dev/migrate_console.php 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

Migrating Collected Addresses

This migration script does not migrate Collected Addresses, but it can be done using a separate script:

Migration from v7 to v8 - Collected Addresses