The Zimbra™ Collaboration Suite (ZCS) Migration Wizard for Exchange is used to migrate Microsoft
® Exchange server email accounts to the Zimbra Collaboration Suite server 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 Zimbra Collaboration Suite.
Accounts from Microsoft Exchange 2000, 2003, and 5.5 can be migrated.
Note: Only email messages, calendars, and address books (including distributions lists)are imported from the Outlook server. Other Outlook types, including notes, rules and alerts, and files are not imported. Unless the ZCS Migration Wizard is run on a machine with Outlook 2003 or Outlook 2007, tasks will not be imported.
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 ZCS 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:
If your users use the Calendar application, and you are not migrating all users to ZCS at the same time, configure ZCS with the same domain name as used on the Exchange server. When ZCS is configured with the same domain name, a user’s existing email address will be retained when the account migrates to ZCS.
Meeting requests and appointments contain recipient information in the form of email addresses. After migration, if the organizer of an appointment updates an existing appointment or if recipients reply to an invitation, the email address of the original message receives the notification. If the email address has been changed, the notification is not received.
After the accounts are created on the Zimbra server, the email messages, calendar entries, and contact information are imported. You configure the following rules for accounts being imported:
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\Zimbra\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.You must also change the
Maximum size of an uploaded file (kb), located in the Administration Console under
Global Settings>MTA, to match the new registry key value.
|
•
|
The local part of the user’s SMTP address in Exchange becomes the first portion of the email address on the Zimbra server. To continue the above example, a user who has an account for joe@marketing.domain.com on Exchange would become joe@marketing.zimbra.domain.com on your Zimbra server.
|
Even though the ZCS Migration Wizard can be run from start to finish without stopping, Zimbra recommends that after the accounts are migrated, you stop. Before proceeding, change the mail relay information to point to the Zimbra server instead of the Exchange server. This will prevent any lost mail while the files are being imported.
|
3.
|
The Import Destination dialog is displayed.
|
|
•
|
Host name. This is the host name of the Zimbra server.
|
|
•
|
Admin Port. The default admin services port is 7071.
|
|
4.
|
In the Destination Domain dialog, select the Zimbra domain name where accounts will migrate.
|

Click
Launch Profile Chooser, to launch a standard Windows dialog box from which you can either choose an existing MAPI profile, or create a new one, as described in the Microsoft Office documentation.
|
6.
|
In the Source and Destination Mailboxes dialog, define the users to be migrated to the Zimbra server. Choose one of the following ways to select users:
|
|
•
|
Object Picker, to select specific users to migrate. Go to step a.
|
|
•
|
Query Builder, to select groups of users to migrate. Go to step b.
|
|
a.
|
Click Object Picker to select specific accounts to migrate.
|
In the dialog, the Object Type is preconfigured with
Users. This cannot be changed.
Click Locations to select the domain from which to select the accounts.
In the Enter object names text box, type the user names or partial user names and click
Check Names. Separate the names with a comma. For example, if you type Jo, all names that begin with Jo are displayed, i.e., Joe Smith, Joseph Flanders, Joanna Writh.
Click Advanced to specify more detailed search (optional).
|
b.
|
Click Query Builder, to select groups of accounts to migrate.
|
In the Active Directory Query Builder dialog, click
Browse to select the base distinguished name (DN) of the container to be used as the root for the search. If you want all folders under the selected DN base to be included in the migration, check
Subtree.
Click OK. The
Source & Destination Mailboxes dialog refreshes with your selections listed in the box.
|
7.
|
The Source & Destination Mailboxes dialog now displays the Zimbra account name, the Exchange Store DN information and the Exchange DN information for accounts to be migrated. Review the information.
|
|
9.
|
The Account Provisioning dialog is displayed. All accounts with the status of No such account are shown in the Unprovisioned Accounts list box. Before creating these accounts, select the Class of Service (COS) that these accounts will be assigned and enter the default password for the accounts.
|
Important: Included in this list are two COSs called default and
None.The COS named
default refers to the default COS that was automatically created when Zimbra Collaboration Suite is installed. The COS named
None is used to represent a COS configured for the domain that is being migrated. Configuring a domain COS is optional. Select
None to provision the accounts with the COS assigned to the domain. If
None is selected and the domain has not been configured with a specific COS, the COS named
default is automatically assigned.
In the Initial Password field, enter a default password. This is the password for every account that is created.
Click Next. The listed accounts are provisioned.
The provisioning of email accounts on the Zimbra server is complete. Before proceeding you should change the mail relay information for these users to point to the Zimbra server instead of the Exchange server. Any new email messages are sent to the Zimbra mailboxes.
|
10.
|
The Import Items dialog is used to select which parts of users accounts should be imported.
|
|
•
|
Calendar Options. If you chose to import users’ calendars, you can specify whether to convert meetings organized by users to their new addresses.
|
|
11.
|
The Import Options dialog is used to set rules about what files should be imported.
|
|
•
|
The checkboxes for Import Junk-Mail Folder and Import Deleted Items Folder determine whether or not to import mail currently in those Junk Mail and Trash folders respectively.
|
|
•
|
The checkbox for Ignore previously imported items can be used in cases where an earlier import operation was interrupted. If checked, the import process picks up where it left off, rather than importing duplicates.
|
|
•
|
Check the Date Filter checkbox to import mail only after a certain date. This lets you discard old messages.
|
|
•
|
In the Concurrency field, set the number of accounts to import simultaneously. Since the import is likely to happen while both servers continue to service other mail accounts, you should use caution when increasing this number, because setting this number too high may affect server performance.
|
Click Next. A confirmation dialog appears. Click
OK to begin importing.
Important: Users can continue to work in Outlook while their mail is being imported, although any operation they do after that mailbox folder has been imported will not be picked up by the Zimbra server. To ensure that the imported mailbox is consistent with the old mailbox, we recommend informing users that their mailboxes will be unavailable over some scheduled downtime period.
The Import In Progress screen displays the import progress.
|
12.
|
When the import is complete, the Import Completed dialog displays any errors. If errors or warnings appear, review the Description column and take appropriate action.
|
|
•
|
Use Import More Users to re-run the import on a different batch of users. You might do this to import users from another domain, for example.
|
|
•
|
Click Finish to close the ZCS Migration Wizard.
|
Copyright © 2007 Zimbra Inc.