Chat now with support
Chat with Support

Migration Manager for Exchange 8.14 - User Guide

Pre-Migration Activities Migration Process Calendar Synchronization Mailbox Migration Public Folder Synchronization Free/Busy Synchronization Tracking the Migration Progress Creating Batches of Synchronization Jobs Outlook Profile Update Fine-Tuning the Agents Using Agent Hosts for Migration Agents Configuring Migration Using PowerShell Appendix A. Measurement of Migration Agent for Exchange Performance Appendix B. Migrating Large Public Folders to Exchange 2013 (or Higher) and Office 365

Changing Mailbox Synchronization Agents’ Settings

You can set the scheduling, logging and other options for each mailbox synchronization agent. The Source Server Properties allow you to configure the Mail Source Agent and the Transmission Agent, and the Target Server Properties allow you to configure the Mail Target Agent. To open the dialog box, right-click the desired server in the management tree and select Properties from the shortcut menu.

It is strongly recommended that you set all the options before you start the migration.

General Options

A number of options are available for the Mail Source Agent and the Mail Target Agent.

The General pages of the source and target agents’ properties allow you to view and modify the following synchronization setting:

  • The Mail Source Agent and the Mail Target Agent store their configuration and statistics in separate database files. You can specify how frequently each database should be compacted.

In addition, for the Mail Source Agent you can specify:

  • Whether only the messages modified recently should be copied to the target.

Caution: If you change the value of the Copy message not older than option, the new value is applied only after the agent is restarted. In addition, if the new value is greater than the old value, you need to perform full resynchronization. If the new value is less, then resynchronization is not needed.

  • The account under which the agent will connect to the AD LDS or ADAM server and the AD LDS or ADAM replica. Since the domain migration and directory synchronization data is stored in the AD LDS or ADAM partition, the agent needs access to the AD LDS or ADAM server and partition where the directory synchronization database is stored.

Caution: Please note that when the Mail Source Agent is processing the mailboxes of a Remote Users Collections, it will ignore the above settings except the database compaction frequency setting. For more information about Remote Users Collections, refer to the Changing Legacy Mailbox Collection Settings topic of this guide.

For the Mail Target Agent, you can also specify whether the agent should archive an incoming PST file that cannot be processed and how long the agent should try to process each PST file.

Data Transfer Units

The Mail Source Agent compresses the PST files before putting them into service PRV files and sending them to the destination servers. The Data Transfer Units page of the source server properties allows you to select whether the agent should compress mail data and to specify the compression rate. If the agent does not compress data, it works faster; however, the network traffic increases because larger files are transferred to the target servers.

You can also specify the maximum size of data put to each PST file.


Every Migration Manager agent saves its logs on the server on which the agent is installed.

For each agent you can specify whether the log file will be overwritten or appended during each session, and select which events will be written to the text log and Exchange server application log files.

Scheduling Options

Each mailbox synchronization agent has its own scheduling options. This lets you define separately when the agents are allowed to put additional stress on the Exchange servers and on the network.

For each agent you can specify:

  • The hours during which each agent is allowed to run. On the agent’s Schedule page of Server Properties, click Synchronization Schedule. Then select the time frame during which the agent should perform synchronization jobs.
  • Whether there should be a sleep period between the agent’s sessions, and the length of that period.

Starting Mailbox Synchronization

We recommend that the first legacy mailbox synchronization job be started after the domain and directory migration are completed, after the public folders are replicated to the target Exchange server, and together with all the calendar and free/busy synchronization jobs for all servers. This will ensure that the first user switched to the target mailbox will:

  • See the full Global Address List (GAL)
  • Have access to the public folders
  • Have access to other users’ free/busy information and (if needed) detailed calendar data

To start the mailbox synchronization agents, perform the following:

  1. Select the legacy mailbox synchronization job in the navigation tree, and then click the Agent Manager toolbar button.
  2. After that in the agent host pane select all necessary agent hosts.
  3. Finally, in the Actions pane click Start Agents.

You can get track the mailbox migration using the Statistics dashboard. For information on how to do that, see Tracking the Migration Progress.

Setting Up a New Native Move Job

A native move job requires the following:

  1. Exchange 2010 Client Access server or Exchange 2013 Client Access server (if applicable) must be deployed in source or target Exchange organization. Also the Mailbox Replication Service Proxy (MRS Proxy) endpoint may need to be enabled for that Client Access server according to your migration plan. For details, see the Enable the MRS Proxy endpoint for remote moves TechNet article.

    NOTE: For the list of Microsoft Exchange organization pairs currently supported by the native move job, see the Mailbox Migration Process.

  2. The target users must be mail-enabled and have the specific attributes that are required for native mailbox move, not mailbox-enabled. For more information, see Specify Exchange Options in the Migration Manager for Active Directory User Guide.

Step 1. Select the Source Exchange Organization

Specify the source organization that mailboxes will be moved from and the credentials to use for performing the move operations.

NOTE: For the list of Microsoft Exchange organization pairs currently supported by the native move job, see the Mailbox Migration Process.

You can specify a single set of credentials for working with both Active Directory and Exchange, or two distinct sets of credentials.

Step 2. Select the Target Exchange Organization

Specify the target organization that mailboxes will be moved to and the credentials to use for performing the move operations.

NOTE: For the list of Microsoft Exchange organization pairs currently supported by the native move job, see the Mailbox Migration Process.

You can specify a single set of credentials for working with both Active Directory and Exchange, or two distinct sets of credentials.

Step 3. Set Up Migration Agent for Exchange

The Migration Agent for Exchange is used for performing native mailbox move operations. This step lets you set up the agent on an agent host that you select.

The default installation path is in the hierarchy of the Program Files system folder. You can customize the path, but your custom path will be used only if there are no previously installed instances of the Migration Agent for Exchange on the computer. Otherwise, the agent will be installed to the same location as the other existing instances regardless of the path you specify.

You can also override the default credentials that the agent will use. However, note that in this case you will be changing the credentials not only for the agent instance you are installing, but also for any existing agent instances on the agent host.

Adding a Native Move Collection

To create a new mailbox collection for an existing native move job, right-click the job in the management tree and click Add Collection.

This will start the Add Mailbox Collection Wizard, which will help you to set up and configure a new collection for the native move job. Each step of the wizard is described below.

Step 1. General Options

Specify the following general options:

  • The name of the native move collection
  • Optionally, a text description
  • Whether the collection will be enabled immediately after creation
  • The mailbox database that the mailboxes in the collection will arrive in
  • The instance of the Migration Agent for Exchange that will process this collection

Step 2. Target Options

Specify the mailbox database to move mailboxes to and the domain part to use in their primary SMTP addresses.

Step 3. Configure Mailbox Switching

The final step in mailbox migration is to switch to the target mailbox, making it the primary mailbox for the user. You can select to perform this step automatically and specify a schedule for it.

However, you may want to defer this step in case there are problems and perform the switch manually when you have made sure the mailboxes are ready.


  • If migration source is an Exchange 2003 organization, mailboxes will always be switched automatically regardless of selected option.
  • If you select to switch mailboxes manually, you need to configure SMTP connector between the source and target organization so that primary SMTP addresses will be routable from the target domain.

Step 4. Workflow

When processing the collection Migration Manager will attempt to follow the schedule you specify on this page. By default, the option to Start as soon as possible is selected. Change this if you want to specify a date when the collection processing should be started.

Do one of the following:

  • Select Start as soon as possible to make Migration Manager start moving the mailboxes in this collection immediately.
  • Select Do not start before to make Migration Manager start processing the collection no sooner than the specified date, but this might not be the first collection in the queue.

An additional workflow-related consideration is how to treat mailboxes with corrupted items (messages) in them.

If you think it is acceptable that mailboxes in the collection may have corrupted messages, select the Skip the corrupted messages option and specify the maximum number of corrupted messages that a mailbox can have and still be moved.

You can supply a number in the range from 1 to 2147483647 (the upper bound effectively means move mailboxes no matter how corrupted their contents are).

Step 5. Collection Items

The collection can be populated with user accounts. To change the user account list, use the buttons next to it.

NOTE: Migration Manager for Exchange does not process groups nested in organizational units (OUs).

Manually Switching Mailboxes

  1. Select the node of the native move collection you need.
  2. In the right pane, go to the Statistics tab.
  3. Select the mailboxes you need in the table at the bottom
  4. Click the Switch action.

Caution: Mailbox switch for mailboxes migrated using native move cannot be undone.

Related Documents