Chat now with support
Chat with Support

Migration Manager for Exchange 8.15 - Source Exchange 2016 Environment Preparation

Source Exchange 2016 Environment Preparation
Preparation Overview Checking System Requirements Setting Up Accounts and Required Permissions Preparing the Source Exchange Environment for Exchange Migration Setting Up Connection with the Target Exchange Organization Using SMTP Connectors

Preparing Public Folder Mailboxes for Public Folder Synchronization

  1. Ensure that the size of public folder data to be migrated does not exceed the size limit for the primary hierarchy mailbox. If public folder content in the source organization is larger than the limit in the target organization, to migrate it you will need to perform specific steps including creation of additional secondary hierarchy mailboxes in your target Exchange 2016 organization. For detailed instructions, see Appendix B. Migrating Large Public Folders to Exchange 2013 or Higher of Migration Manager for Exchange User Guide.
    TIP: For general information on public folders in Exchange 2016, see
  2. For each public folder mailbox consider adjusting the Recoverable Items quota according to the needs of your Exchange 2016 organization (by default, the limit is 30 GB per mailbox). If the quota limit is exceeded for a public folder mailbox, deletions of content in the source public folders will not be synced to that target public folder mailbox anymore.
    To change the quota value for a public folder mailbox, invoke the following cmdlet:

Set-Mailbox -Identity PFMailbox –PublicFolder -RecoverableItemsQuota 50GB

Creating Outlook Profiles for Public Folder Synchronization

To synchronize public folders with Exchange2016 organization, you need to create special Outlook profiles on the agent host associated with Exchange 2016 where you plan to install PFSA and PFTA.

For that, log on to agent host under the Agent Host Account, open Start | Control Panel | Mail (32-bit) and click Show Profiles. You must create two profiles: one named MMEX_PFSA and the other — MMEX_PFTA. To create each profile, take the following steps:

  1. Click Add and then specify the profile name (either MMEX_PFSA or MMEX_PFTA, respectively). Click OK.
  2. Specify the administrator mailbox you plan to use for public folder synchronization.
  3. Click Next and wait until wizard connects to the mailbox. If prompted for credentials, specify Source Exchange Account credentials and select the Remember my credentials option.
  4. Select the Change account settings option and click Next.
  5. Clear the Use Cached Exchange Mode option.
  6. Click Finish to complete the wizard.

To ensure that logon to created profiles through Outlook can be performed correctly, run Outlook 2013 and select the MMEX_PFSA (MMEX_PFTA) profile. If no error messages, credential prompts or any other message boxes that require user response appear, then profile is created properly and therefore can be used by PFSA and PFTA to perform public folder synchronization.

Note: Make sure that no issues related to certificate validation occur when you run Outlook. For instance, if you use self-signed certificates for Exchange 2016 Servers, you need to log on to each agent host under the Agent Host Account and add certificate from to the Trusted Root Certification Authorities and Trusted Publisher lists.


Fine-Tuning Public Folder Synchronization Agents to Use Kerberos Authentication (Optional)

Fine-Tuning Public Folder Synchronization Agents to Use Kerberos Authentication (Optional)

During public folder synchronization, agents establish PowerShell session with source or target Exchange Server to process mail-enabled public folders. If only Kerberos authentication is available in the environment, then force each deployed PFSA or PFTA to use Kerberos authentication as follows:

  1. Locate CONFIG.INI file of an agent.
  2. Add the following line to the INI file and save the file:
  3. Restart the agent.

Setting Exchange Autodiscover URL (Optional)

Migration Agent for Exchange uses the Exchange Autodiscover service to query certain properties of mailboxes being migrated. In order to submit queries to the Autodiscover service, MAgE needs to know its URL. In most cases, the agent automatically gets the Autodiscover URLs for both the source and target organizations. However, you may experience situations when automatically discovering the URL fails or returns the incorrect URL.

When the correct URL cannot be obtained, an error will be generated causing the synchronization job to fail. Errors in the log file with the following exceptions indicate problems with obtaining the proper Autodiscover URL:

  • AutodiscoverLocalException: The Autodiscover service couldn't be located.
  • ServiceRequestException: The request failed. The remote server returned an error: (401) Unauthorized.
  • ServiceRemoteException: Invalid user: ''.
  • AutodiscoverDeploymentIdMismatchException: The User Deployment ID returned from Autodiscover does not match the expected value.

If you encounter any of the above exceptions, you need to manually configure the Autodiscover URL for the source or target organizations (or both) . The Autodiscover URL can be configured using the Set-MMExOrganizationProperties cmdlet from the MMExPowerShell module. Below is an example how to use the cmdlet:

Set-MMExOrganizationProperties -FQDN -AutodiscoverUrl

TIP: For information how to use the MMExPowerShell.psm1 module, see Configuring Migration Project Settings Using PowerShell.

Related Documents