IceWarp Unified Communications Kerio Migration Guide Version 12.0
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 3
Kerio Migration Guide 4 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 support@icewarp.com (or https://www.icewarp.com/support/iw-license/ ). c) Contact your local IceWarp representative.
Kerio Migration Guide 5 2. Copy the keriomigrate.exe file to the IceWarp Server installation folder.
Kerio Migration Guide 6 3. Use Notepad to create the kerio.conf file and save it into the same folder.
Kerio Migration Guide 7 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.
Kerio Migration Guide 8 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.
Kerio Migration Guide 9 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.
Kerio Migration Guide 10 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!
Kerio Migration Guide 11 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: john.doe@keriomail.com:password1 jane.doe@keriomail.com: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.
Kerio Migration Guide 12 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 john.doe@keriomail.com
Kerio Migration Guide 13 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 support@icewarp.com (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.
Kerio Migration Guide 14 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 john.doe@keriomail.com u_name John Doe u_password password1 b) Bulk creation: Create a file which includes username and password john.doe@keriomail.com,john Doe,password1 jane.doe@keriomail.com,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 username@domainname.com (Example:./keriomigrate.sh jane.doe@keriomail.com You need to see below: