Migrate data from Exchange

G Suite Migration for Microsoft Exchange

If you've set up your organization to use G Suite, you can migrate users' mail, calendars and contacts from your Microsoft® Exchange environment to G Suite using G Suite Migration for Microsoft Exchange (GSMME).

Step 1: Get ready

  • System requirements—Check that you meet the system requirements for GSMME.
  • User accounts—Create a list of user accounts that you are migrating. The format of the CSV file for users depends on the system from which you are migrating. Learn more about creating a CSV file for users (control file).
  • Calendar resources—If you are migrating calendar resources, you should also create a CSV file for calendar resources (mapping file). 

Step 2: Authorize GSMME for your domain

Before you can install GSMME, you must authorize the software for your domain. For details, see Authorize GSMME for your domain.

Step 3: Download and install GSMME

  1. Click Download GSMME and then Download Migration Tool.
  2. Open the installer and follow the instructions to install GSMME.

Step 4: Configure GSMME

Complete these steps in the GSMME tool.

Step 1: Server details
  1. For Server Type, select Exchange.
  2. In the Hostname/IP Address field, enter your domain name or the IP address of the email server from which you want to migrate data. For example: smtp.mydomain.com or 198.102.434.8.
  3. In the Admin username field, enter the username for the Exchange administrator account you want to use to open your users' mail stores.
  4. Calendar resources: If you are migrating calendar resources, do the following:
    1. To avoid migration errors, use a separate G Suite admin account for each GSMME instance. 
    2. Change the number of parallel migrations in GSMME from 25 (default) to 1.

    For more information on migrating calendar resources, see the "Best practices for your migration" chapter in the GSMME Admin Guide.

  5. Click Next.
Step 2: User and domain information
  1. In the G Suite domain name field, enter the new primary G Suite domain where the data will be migrated.
  2. In the Service account credentials file field, enter the path to your credentials JSON file that was created as part of the authorization process.
  3. In the G Suite admin user field, enter the full email address of your G Suite domain super administrator.
  4. Click Next.
Step 3: Migration settings
  1. Select the checkbox for each type of data you want to migrate: email, calendar, or contacts.
  2. Click Next.
  3. Review and optionally make changes to the settings:
    • Migrate all data—Only use this option if you are migrating an account again.
    • Save settings—When checked, GSMME retains the current configuration for future use.
    • Run Diagnostics—When checked, GSMME verifies the configuration before running the migration.
    • Estimate—When checked, GSMME estimates the message count for the source users.
    • Migrate—When checked, GSMME performs the migration.
  4. Click Next.
  5. In the dialog box that appears, enter the username and password for the Exchange administrator account you are using to open your users' mail stores. Selecting Remember my password will bypass this step in future migrations.
  6. Click OK to begin the migration process.
To learn more about GSMME, see the GSMME Admin Guide, which includes detailed information about how GSMME works, getting started, and running your migration.
Was this helpful?
How can we improve it?