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.
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,
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.
dev/migrate_console.php script, provide full path to v7 installation:
$sP7ProductPath = "PATH_TO_YOUR_WEBMAIL_V7_INSTALLATION";
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:
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