4  Migration process

Connection test

Create a new profile in MS Outlook on the computer where the Kerio Exchange Migration Tool is installed. This profile will include an account with rights for the Microsoft Exchange Server's administration. Try to use the account to connect to Microsoft Exchange Server. If the connection was successful, the migration is ready to start.

Launching migration

Check the following example:

  1. If MS Outlook is running, close it.

  2. Run Kerio Exchange Migration Tool, for instance from Start → Programs → Kerio → Exchange Migration Tool → Kerio Exchange Migration Tool.

    Warning

    Never start the migration tool if it is already running.

  3. The migration tool is opened as a wizard where login information for the Microsoft Exchange Server and then for Kerio MailServer is required.

    Username and password for Microsoft Exchange Server must belong to an account with the server administration rights.

    Username and password for Kerio MailServer must belong to an administration account of the Kerio MailServer's primary domain (the same username and password which was used in the initial configuration dialog upon the server installation).

  4. For connection to both servers, check all user accounts to migrate in the Select Users dialog (see figure 1  User selection dialog).

    It is possible to migrate either all or just selected users. The migration process may be time-consuming. Therefore, it is recommended to migrate data by parts (see section 2  Before you start).

    User selection dialog

    Figure 1. User selection dialog


  5. At the start of migration, the Migration Status window (see figure 2  Dialog displaying status of migration of particular mailboxes) 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:

    Dialog displaying status of migration of particular mailboxes

    Figure 2. Dialog displaying status of migration of particular mailboxes


    • Data of users whose migration has been completed will be saved in Kerio MailServer.

    • 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. If the user is migrated again, the data already migrated gets duplicate. For this reason, it is recommended to remove the partly migrated users in the Kerio MailServer's administration interface before executing another migration. To find out which users were involved in an interrupted migration, see the migration report (for details, see section 5  Migration process logs).

    • Users in the status that indicates they have not been migrated yet do not have accounts created in Kerio MailServer and they can therefore be migrated within one of the following batches.

    Migration interruption may take several minutes. The time equals to the time needed for completion of migration of the item currently in progress.

  6. When the migration is completed, switch to the Migration Result page (see figure 3  Migration result dialog). This page sums up information about the migration which has just been completed.

    To get migration process details and reports of possible errors, click on the Report link.

    If user accounts have not been created, mapped or imported in the Kerio MailServer,new user passwords can be found in the Report log. For security reasons, it is highly recommended that users change them upon their earliest connection to their account.

    Migration result dialog

    Figure 3. Migration result dialog


Once a migration is completed successfully, it is recommended to create new accounts in your email clients (or profiles, if supported by the applications). This will help you avoid data inconsistence on the client sides. Details on how to set for example profiles in MS Outlook or a new account in MS Entourage, refer to Kerio MailServer 6, User's Guide.