Migrating Exchange account via ZCS Migration Wizard for

Exchange
Technical Custodial: Chris Wilson
User of document: Technical Support migrating an end user, Zimbra Technical Team

This procedure assumes a technical support person is performing the migration for the user. The user in
this example is Wilson, Chris, the technical support person is Wilson, Chris (admin) two unique
accounts.
Image 1:

Make sure you grant the Active Directory account youll be using for the migration, the proper
access to the mailbox in-question, available from the Exchange Advanced / Mailbox Rights section
of the users AD/Exchange account object. (E.g. in this case Wilson, Chris (admin) account was
added to this account with Read and Full Mailbox Access)

Image 2:

One of the requirements of a migration done via the ZCS Migration Wizard for Exchange, is that
the targeted account must have the same username as the account being migrated. Since Zimbra
authenticates against NetID, this may not be the case for most customers. So an Alias can be added
to the Zimbra account in the format of AD_Username@target-domain. For this document weve
added alias cwilson2@z.rochester.edu to the real account of cwils12@z.rochester.edu.

Image 3:

Launch the ZCS Migration Wizard for Exchange. This utility requires Microsoft Outlook to exist
on the machine, and that you have an Exchange profile setup. I regularily use the software from
our Terminal Server, its-w2ks51.ur.rochester.edu. Make sure Outlook isnt already running
before starting the application.

Image 4:

Enter your admin-level credentials related to our Zimbra environment.

Image 5:

If you get the above notification, click Cancel. The version of the software weve been using matches
the version of the software on our Zimbra servers, apparently the version-check does not function
properly.

Image 6:

Select the target domain within the Zimbra environment. In this document we are migrating to an
account on the z.rochester.edu domain.

Image 7:

Here you are being prompted for the Exchange profile you have setup in Outlook. Hit Launch
Profile Chooser and select the appropriate profile to continue.

Image 8:

Click Object Picker to search for the Exchange account you intend to migrate.
Image 9:

In this document we are migrating my own account. Enter the name and hit Check Names.

Image 10:

If presented with multiple options, select the correct account and click OK.

Image 11:

Click OK when youre sure youve selected the correct account for migration.

Image 12:

You will be presented with the assumed target-account. As mentioned above, this will be the
AD_Username@target-domain. So in this document it is cwilson2@z.rochester.edu.

Image 13:

If the target-account does not exist, you will be informed. If this occurs then the your intended
target-account has been given a matching Alias, as described above.

Image 14:

For most migrations youll be selecting everything. But for those fussy ones, you can choose to do
one portion of the Exchange mailbox at a time.

Image 15:

Theres no reason to migrate the Junk-Mail Folder, but I normally keep the Deleted Items Folder
selected.
Image 16:

Click OK to get things started.

Image 17:

The utility will count through the Exchange mailbox, and once its gotten a total count, will begin to
progress with the migration.

Image 18:

Once the process is complete you will be presented with the summary.

Image 19:

Click Open Log File to open the migration log in Notepad.

Image 20:

Save off the file some place safe, named accordingly, for future reference if necessary.

Image 21:

Image 22:

Click Finish, and the process is complete.

Dont forget to remove the rights you granted to the users Exchange mailbox, back in the beginning
of the process, once youre finished.