Troubleshoot an Exchange migration

Google Workspace Migration for Microsoft Exchange

When using Google Workspace Migration for Microsoft Exchange (GWMME), you might experience difficulty accessing users' Exchange mailboxes. Use the following troubleshooting tips to help you identify the root cause of why an Exchange migration is failing. 

Try the Log Analyzer

Submit your trace logs to the Google Admin Toolbox Log Analyzer. Most issues can be identified within a few moments of submission.

Before you begin

  • Make sure that Microsoft Windows and Outlook have the latest updates.
  • Sign in to Windows with the administrator account for the migration. Doing so prevents pop-ups.
  • If Windows or Outlook are not in English, run GWMME on a machine with English editions of Windows and Outlook.
  • Make sure to use Outlook 32-bit and not 64-bit.

Step 1: Verify your settings

Outlook profile

  1. Create an Outlook profile for the administrator user and use this profile for the migration. (Select this profile when you enter a value in the Specify a profile to use for migration field in GWMME.)
  2. If you get: 
    • Auto-discovery boxes when you set up the Outlook profile for the admin user, check the Always allow box before accepting the terms.
    • A box asking for a username and password when setting up the profile or opening Outlook, check the option to save username and password.
  3. Verify the admin user can access users' mailboxes:
    1. Open the admin Outlook profile you created, then open another user's mailbox.
    2. Navigate to the user's Inbox and check that you can read their messages.

For information about adding another person's mailbox to your profile, consult your Microsoft documentation.

Global Address List

  • In the Outlook profile for the admin user, open the Global Address List (GAL). Check that it loads correctly.
  • Make sure that the admin account is a mailbox user and not hidden from the GAL.
  • Check that the admin profile is not set to use Cached Exchange Mode.

    See Microsoft's documentation for information on how to turn off Cached Exchange Mode.

CSV file

First, make sure that users specified in your CSV file don't have Out of Office status turned on.

Then, in the Exchange username field in the CSV, enter just the username, without the domain name (for example, username and not domain/username).

For more information, go to Create a control CSV file for user accounts.

Finally, run the migration again. If it still doesn't work, proceed to step 2.

Step 2: Troubleshoot errors after a migration

In step 1 of GWMME, in the Hostname/IP Address field, use the hostname of the Exchange server and retry the migration. If that doesn't work, try the Exchange server's IP address.

In rare situations, you can resolve issues by granting the administrator send and receive permissions. Try switching this setting in Microsoft Exchange. For details, consult your Microsoft documentation.

Contact support

If these troubleshooting steps don't resolve your issue, contact Google Workspace support.

Have available: 

  • A ZIP file that includes the files found at C:\Users\username\AppData\Local\Google\Google Apps Migration\Tracing\ExchangeMigration
  • The CSV file or files you used for the migration

Related topics


Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.

Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue