Preparing to Use the Migration Wizard

Preparing to use Migration Wizard

   KB 1503        Last updated on 07/12/2015  

(0 votes)
 - This article is a Community contribution and may include unsupported customizations.
 - This is archive documentation, which means it is not supported or valid for recent versions of Zimbra Collaboration.
 - This article is a Work in Progress, and may be unfinished or missing sections.

Migrating from Microsoft Exchange to Zimbra Collaboration Server

The Zimbra Migration Wizard for Exchange (ZCS Migration Wizard) is used to migrate Microsoft® Exchange server email accounts to the Zimbra Collaboration Server (ZCS) and to import the email, calendar and address book information for the selected Exchange users. The import process replicates the user’s Outlook® folder hierarchy, importing email messages, calendars, address books and distribution lists from the Exchange server. Any keywords are converted to tags in ZCS.

Accounts from Microsoft Exchange 2000, 2003, 2007 and 5.5 can be migrated.

During the migration, the wizard performs the following tasks:

Creates the user account on the ZCS server, if it does not already exist
Imports email messages, attachments, calendars, and address books
Creates a log file for troubleshooting any import errors or warnings

Note: Only email messages, calendars, and address books (including personal distributions lists) are imported from the Exchange server. When the ZCS Migration Wizard is run on a machine with Outlook 2003 or Outlook 2007, tasks are imported. Other Outlook types, including notes, rules and alerts, and files are not imported.

Important: The Zimbra Migration Wizard utilizes the Exchange MAPI provider. Therefore, you must run the migration wizard from a Microsoft Windows ® computer that has either Outlook 2003, 2007, or 2010 installed. You must NOT have Microsoft Exchange. You will need to create a temporary MAPI profile for the Migration Wizard to use to conduct the migration. To create a new profile, refer to the Microsoft Office documentation.

Permissions Needed for the Zimbra Migration Wizard

When you run the Zimbra Migration Wizard, the wizard prompts you to select the MAPI profile that will be used to connect to the Exchange server. You must have full administrator privileges on the mailboxes to be imported.

The account under which you log in to Windows must have permission to open the temporary MAPI profile you created for the migration, and the account must be a member of the Windows domain administrators group.
The MAPI profile specifies a single account that will be used to open and import all mailboxes.

Planning the Migration from Exchange to Zimbra

Before you attempt to migrate from the Exchange server, create a communication plan to notify users about the new Zimbra email program and to provide users with the new mail access information (Zimbra URL, login name, and password to use).

Zimbra recommends that you plan to perform the migration during off-peak use times. The Exchange server does not need to be stopped in order to migrate accounts. Any emails that are sent to or delivered from Exchange after the account is migrated are not saved in the Zimbra mailbox.

The migration wizard asks you questions in a series of dialog boxes about how to set up the new accounts. Before you start, you should determine:

Which domain the users accounts will migrate to.
How you want to migrate accounts. Do you want to select individual accounts or select groups of accounts to import?

After the accounts are created on the Zimbra server, the email messages and contact information are imported. You configure the following rules about which files to import:

Import the content of Junk-Mail folders, yes/no
Import the content of the Deleted Items folder, yes/no
Import email messages received after < what date>

By default, messages larger than 10 MB will not be imported. The message size includes the message and attachments. If the message is larger than 10 MB, a warning is logged to Migration Wizard log file, which can be reviewed from the Import Complete dialog when the migration is complete.

Note: You can modify the following registry key to change the default limit, "HKCU\Software\ZCSMigWiz\MaxAttachSizeMB". The registry key should be specified in megabytes (MB). A value of 0 means no limit to the size of the message with attachments.

The import process contains a few assumption regarding naming:

Imports are by a single domain. For example, you might import users from on your Exchange server to on your Zimbra server.
The user’s Common Name (CN) in Exchange will be the first portion of the email address on the Zimbra server. To continue the above example, a user who has an account for on Exchange would become on your Zimbra server.
Verified Against: Zimbra Collaboration 7.0, 6.0 Date Created: 04/16/2014
Article ID: Date Modified: 07/12/2015

Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search