Server migration (Linux -> Linux)

Migration guide

To migrate you first must make sure you have a backup of everything, the mail, the groupware database, etc. To be safe backup the entire /Icewarp folder just so you know you have a full backup.

Migration steps:

1. Install version same version on both servers.

2. Copy over the following folders from the old to the new server:
Mail (must be copied through a tool that saves timestamps - rsync)
Spam (if using the default anti-spam database)
Calendar (if using the default groupware database)
Config

3. During migration you cannot have the same license on both servers. On the new server activate a trial license which you can purchase: https://shop.icewarp.com/purchase/get_trial.php.

4. Activation of Order ID using tool.sh

/opt/icewarp/tool.sh modify system c_onlinelicense EUR2020xxxx-xxxxxx-xxxxx

After doing this you will be running the same settings, users, domains, etc. on the new server.

*** If using the file system for accounts ***

Export users and domains and copy them on the new server:

/opt/icewarp/tool.sh export account "*@*" u_backup > /bck_acc_backup.csv
/opt/icewarp/tool.sh export domain "*" d_backup > /bck_dom_backup.csv

Import of the users and domains from the copied file:

/opt/icewarp/tool.sh import account /bck_acc_backup.csv
/opt/icewarp/tool.sh import domain /bck_dom_backup.csv

*** For the creation of DB in MySQL on the new server ***

(create collation based on the location, more - https://mariadb.com/kb/en/supported-character-sets-and-collations/):

CREATE DATABASE accounts default charset utf8mb4 collate utf8mb4_unicode_ci;
CREATE DATABASE antispam default charset utf8mb4 collate utf8mb4_unicode_ci;
CREATE DATABASE groupware default charset utf8mb4 collate utf8mb4_unicode_ci;
CREATE DATABASE webclient default charset utf8mb4 collate utf8mb4_unicode_ci;
CREATE DATABASE eas default charset utf8mb4 collate utf8mb4_unicode_ci;
CREATE DATABASE dircache default charset utf8mb4 collate utf8mb4_unicode_ci;
CREATE DATABASE asreports default charset utf8mb4 collate utf8mb4_unicode_ci;

*** If using the MySQL databases do a DUMP of DB ******

1. For export of DB do: mysqldump -hDB_HOST -uDB_USER -pDB_PASSWORD --opt --quote-names --skip-set-charset --default-character-set=utf8mb4 --single-transaction EXAMPLEOFDB > /exmpleofdb.sql
2. This will create a DUMP in root (/) location
3. For import of DB to the new server do the following: mysql -hDB_HOST -uDB_USER -pDB_PASSWORD --default-character-set=utf8mb4 exampleofdb < /exampleofdb.sql

You can migrate only these DB's: accounts, antispam, antispam-reports, groupware. The rest of the databases: directory cache, webclient, and EAS are caches and it's not necessary to migrate them.

After this switch value in API console:
system.mysqldefaultcharset utf8mb4

*** After migration ***

After migration stop all services on the old server and activate your license on the new server using remote console - Help - License - Activate License... - insert Order ID from the old server

If you didn't migrate directorycache then start a refresh of dir cache for the whole server in System - Advanced - Directory Cache