How to Perform a Migration using the Data Migration Service

With the new Data Migration Service, you can now bulk migrate email data for up to 500 User Accounts at a single time.

Setting up the Data Migration Service

Ensure you are signed in as the Super Administrator of your Google Workspace Account.

  • Go to the Google Workspace Admin Console:
  • Navigate to Menu > Account > Data Migration.

Navigating to Data Migration

  • Here, you will need to click on GO TO DATA MIGRATION (NEW)

Clicking on Data Migration

  • You will get to a page as seen from the image below.

New Data Migration Page

Step 1: Connect to Source Google Workspace Account

Here, you will need to input the email address of a super admin account within the Google Workspace Account.

Next, you should click Request Authorization to send an authorization request to the admin email address.

Connecting Super Admin Account

You will receive an email asking you to View the authorization request sent.

Authorization Request

Once you click on View authorization request, you will be redirected to a new page where you will now be able to Authorize the admin account.

Authorize Request Acceptance Page

Here, you will now get a new prompt showing you that the request has been granted.

Authorization Request Granted

You now need to go back to the admin console and click on Verify Authorization to connect the admin email address and set it up for Data Migration.

Step 2: Upload Migration Maps

In a Google sheet, provide migration mapping with the Source and Destination of the migration. The migration can handle up to 500 users at a time and migrate to different destinations. The headings of the two columns should read as follows:

Download the Google Sheet as a comma-separated values file (.CSV file). Make sure there are no white spaces in the data.

Go back to the Amin Console and click on Upload migration map CSV. Then select the downloaded CSV file and upload it.

Uploading the users to be migrated

Once the CSV file has been successfully uploaded, it will appear as shown above and you can proceed to the next step.

Step 3: Configure migration settings

Select the start date of when to start migrating emails. This can be a custom date depending on preference. Click the checkboxes to migrate deleted emails and spam mail if at all needed and click save. 

Migration Settings page

Step 4: Migrate

To start the migration, click on the start migration button. The system will automatically run and find tasks to be migrated and start the migration. The analysis includes Warnings, Failed migrations, skipped migrations, and successful migrations.

Once the migration is complete, you can run Delta migration to copy new or modified messages, and to retry failed messages. The delta migration skips previously migrated emails.

It is also possible to to download a migration report to troubleshoot errors and failed migrations.

Execution history is a drop down that gives access to migrations that have happened before with their migration reports.

Execution history after running a Delta Migration