User manual KERIO TECHNOLOGIES IMAP MIGRATION TOOL

[. . . ] Domains Users Email folders in mailboxes Email messages If the source IMAP server supports groupware data (contacts, events, tasks, etc. ) and the data is available via the IMAP protocol, the data will be included in the migration. However, the Kerio IMAP Migration Tool does not perform conversion of such data. In the Kerio Connect store, they are saved in the same format as on the source server. [. . . ] The migration tool can also be installed on both the source or target mailserver. Before starting the migration, it is recommended to make sure that the source email server cannot accept new emails temporarily. Otherwise, migrated data might be inconsistent. The migration requires that both the Kerio Connect and the source IMAP server are running. 4 Migration process The following description addresses the procedure of starting of the migration tool especially on Windows. However, you can follow the guidelines even if you run it on Mac OS X or Linux. Windows: Run Kerio IMAP Migration Tool, for instance from Start Programs Kerio IMAP Migration Tool. Mac OS X: Double-click on the KIMT icon or drag it to Applications. Linux: Unpack thee TGZ file including the Kerio IMAP Migration Tool application and run the program. Table 1 Installation on individual operating systems Do not start the migration tool if it is already running. The migration tool is a wizard which will ask for IP address or DNS name of the source IMAP server and login information for Kerio Connect (you will need to log in with the name and password of the primary administrator). Note: · If you want to use SSL-secured connection to the source IMAP, check Use SSL connection. · The migration tool will not affect accounts on the source server, but for security reasons it uses them just in the read-only mode, so that it is possible to interrupt the migration process and keep using the original server until migration of other users. Migration also does not remove the existing data or settings in Kerio Connect. Migrated data will be added as extra data. Therefore, beware of possible data duplication (data gets duplicated if one account is migrated twice). Once you are connected to both servers, use the Load button in the Choose Accounts For Migration users to load the CSV file with users and select user accounts to be migrated (see figure 3). The migration process may be time-consuming. Therefore, for time-saving reasons it is recommended to migrate data by parts (see section 2). 1 Kerio IMAP Migration Tool requires X Window System 3 Figure 3 User selection dialog 4. At the start of migration, the Migration Status window (see figure 4) is opened, showing the current status of the migration progress. If the migration process is interrupted (finished without being completed) deliberately, the following results take effect: Figure 4 Dialog displaying status of migration of particular mailboxes 4 · Data of users whose migration has been completed will be saved in Kerio Connect. · In case of users whose migration was just being in progress in the time of the interruption, only part of the data (data having been migrated completely at the moment) is migrated. [. . . ] On MS Windows, they can be found in the following directory: %TEMP%\KimtLogs\MMDDYYYY_HHMMSS on Windows Vista, the path to logs can be for example like this: C:\Users\wsmith\AppData\Local\Temp\KimtLogs\02182009_154844 On Linux, they can be found in the following directory: ~/KimtLogs/MMDDYYYY_HHMMSS for example: /home/wsmith/KimtLogs/02182009_154844 On Mac OS X, they can be found in the following directory: ~/Library/Logs/KimtLogs/MMDDYYYY_HHMMSS for example: /Users/wsmith/Library/Logs/KimtLogs/02182009_154844 Each start of the migration tool generates a new log. Should you contact the Kerio Technologies technical support to shoot various migration issues, please send both logs attached to your report. The Report log The Report log is the report. txt file that can be found in the log folder. After completion of each migration, it is recommended to read through this file to make sure that no errors occurred and that all user accounts have been migrated correctly. Debug Log The Debug log is the debug. log file that can be found in the log folder. [. . . ]