kerio migration guide - icewarp mail...

IceWarp Unified Communications

Kerio Migration Guide Version 12.0

IceWarp Server Published on 2017-12-14

Kerio Migration Guide 2

Contents

Kerio Migration Guide........................................................................................................................................ 4

For Windows Operation Systems

Pre-Migration ..................................................................................................................................................... 4

Migration ........................................................................................................................................................... 8

GUI ..................................................................................................................................................................... 9

Command Line Migration ................................................................................................................................ 12

For Linux Operation Systems

Pre-Migration ................................................................................................................................................... 13

Migration ......................................................................................................................................................... 14



Kerio Migration Guide

The document will guide you through a process of migration from Kerio to IceWarp Server on Windows and Linux platforms.

For Windows Operation Systems

Pre-Migration

1. Get Migration Tool – you can get it one of below options.

a) Download it from this link: https://www.icewarp.com/download-premise/migration-tools/

b) Ask our support at [email protected] (or https://www.icewarp.com/support/iw-license/ ).

c) Contact your local IceWarp representative.

https://www.icewarp.com/download-premise/migration-tools/

mailto:[email protected]

https://www.icewarp.com/support/iw-license/



2. Copy the keriomigrate.exe file to the IceWarp Server installation folder.



3. Use Notepad to create the kerio.conf file and save it into the same folder.



4. On the IceWarp Server, create a domain you want to migrate.

If you have IceWarp Server which already has some domains created, specify IP binding for the domain.

Or set login policy to log in with user names (Management – Policies).

NOTE: Otherwise all accounts are migrated to the primary domain.



Migration

BE AWARE: Data will be deleted in specified Kerio mail folder!

Specify full path to the Kerio mail folder in the kerio.conf file.

a) Kerio “mail” folder is on the same machine as IceWarp Server.

Specify full path to the Kerio mail folder in the kerio.conf file.

b) Kerio “mail” folder is on the network share.

To avoid problems with access rights , you share the mail folder to “everyone”.

Try to open this folder from the server where IceWarp Server is installed – use UNC path.

Start POP3 service with a user that has write/read rights for this folder.



Specify the UNC path to Kerio “mail” folder in the kerio.conf file.

NOTE: After this step, you can use GUI or CLI migration.

NOTE: It is possible to exclude mail items from migration – put dont_process_mails on the second line in the configuration file.

GUI

BE AWARE: Kerio server must be running!

1. In the IceWarp console, navigate to the System – Tools – Server Migration node.

2. On the General tab specify all details.

3. Migration directions:

a) On the General tab, specify IP address (Source host) of the current server you want to migrate to IceWarp Server.

b) Migration account: Specify any account existing on IceWarp Server. This account is only for technical reasons – if you do not have any such an account on IceWarp Server, you have to create one and fill its email address here.

c) Post migrate script: Full path to the keriomigrate.exe file.

d) Click Start button.



e) This is a fully automatic migration – each user is “physically” migrated when he/she logs into IceWarp WebClient. The whole migration is finished when all users log into IceWarp WebClient. You can see alert of when an user try to login WebClient below:

NOTE: Do not click the Finish Migration button before!



f) If you want to perform bulk migration:

Fill in the path to the file (Bulk file) that contains login credentials of all remote server users

Example:

[email protected]:password1

[email protected]:password2

Navigate to the Manual tab and select the Bulk user option and select file which you create that contains login credentials of all remote server users.

Click Migrate Accounts button.



4. You can see migration details in Logs tab.

5. Click the Finish Migration button when you done.

Command Line Migration

1. Open Command Line (Windows Key+r and write cmd). Command Line must be running with Administrative privileges.

2. Navigate to IceWarp installation folder and use below command for each user who you want to migrate:

keriomigrate [email protected]



For Linux Operation Systems

Pre-Migration

1. Install IceWarp Server. Check below guide for details:

http://www.icewarp.com/download/documentation/server/installation/V%2012%20Installation%20and%20Control%20in%20Linux.pdf

2. Get the Migration Tool – you can get it one of below options: a) Ask our support at [email protected] (or http://esupport.icewarp.com)

b) Contact your local IceWarp representative.

3. Prepare migration files:

a) Copy the keriomigrate and keriomigrate.sh files to the IceWarp Server installation folder.

While you are in folder which includes keriomigrate and keriomigrate.sh files

# cp –i keriomigrate keriomigrate.sh /opt/icewarp

Give permissions:

While you are in IceWarp installation folder While you are in IceWarp

# chmod 744 keriomigrate.sh

# chmod 744 keriomigrate

b) Create a file named kerio.conf in IceWarp installation folder (default/opt/icewarp/):

Specify full path to the Kerio mail folder in the kerio.conf file

Example:

# vi/opt/icewarp/kerio.conf

NOTE: It is possible to exclude mail items from migration – put dont_process_mails on the second line in the configuration file.

Final:

4. You can pass one step further if you create domain you want to migrate while you install IceWarp Server.

a) On the Icewarp Server, create a domain you want to migrate:

While you are in IceWarp installation folder.

# vi ./wizard.sh

[ENTER]

[1] Accounts and Domains management

[1] Add new domain

Write domain name (Example: keriomail.com).

You can write a domain description (it can be left blank).

Write an admin account for this domain.

OK? [Y/n]: Press Enter or write Y and press Enter.

Add another domain? [Y/n]: Write n and press Enter.

Domain is created.



mailto:[email protected]

http://esupport.icewarp.com/



Migration

BE AWARE: Data will be deleted in specified Kerio mail folder!

1. Create users which you want to migrate from Kerio in Icewarp

a) One by one creation:

While you are in IceWarp installation folder:

./tool.sh create account [email protected] u_name “John Doe” u_password “password1”

b) Bulk creation:

Create a file which includes username and password

[email protected],John Doe,password1

[email protected],Jane Doe,password2

./tool.sh import account keriomigratebulk.txt u_name u_password

While you are in IceWarp installation folder:

Use below command:

./keriomigrate.sh [email protected] (Example: ./keriomigrate.sh [email protected]

You need to see below:

kerio migration guide - icewarp mail...

Documents