The new data migration service is currently in public beta and is subject to the "Pre-general availability offerings terms" section of the Google Workspace Service-Specific Terms.
Here’s how to fix problems you might have when setting up and migrating data with the new data migration service.
Authorization
- Check the email address of the super admin
- Verify that the super admin has given consent
- Check that the email link is valid
Set up & run a migration
- Error in uploading map
- Migration fails to start
- Migration completes, but there are failed items
- Missing messages
- Errors migrating labels
Authorization
Check the email address of the super admin
Make sure you entered a correct and valid email address of a source domain Google Workspace super administrator.
If you get an error when trying to access the authorization request, the email has been sent to someone who isn't a super administrator on the source domain. To fix the issue, in your Google Admin console on the target domain, click Disconnect and create a new connection using a valid super administrator email address for the source account. For details, go to Run a migration.
Verify that the super admin has given consent
If you are a super administrator on the source account, to verify whether you gave consent to the authorization:
- Go to the domain-wide delegation settings in the source account.
- Check whether Data Migration (New) is listed as a client.
For more details about domain-wide delegation, go to Control API access with domain-wide delegation.
- If it isn't listed as a client, authorize by clicking the consent link sent in the authorization request email.
Check that the email link is valid
The authorization consent link expires after 24 hours. If the super admin on the source account doesn't grant consent within that time frame, click Resend email to send a refreshed link to them.
Set up & run a migration
Error in uploading map
You might get one of the following errors when uploading the migration map:
Error message | Steps to troubleshoot |
---|---|
Entry already exists | You added a source email address more than once. Check your migration map for duplicated source users (it's OK to list the target user more than once). |
Target Gmail Account Entity must be set | A target email address is missing. Check the CSV file for missing target users. |
Email Id for Gmail Account entity must be set and valid | Make sure the email addresses in the file are set and use valid email formats. |
Migration fails to start
Make sure that a target domain super admin starts the migration. The new data migration service requires super admin privileges as it grants domain-wide delegation in the target domain before beginning the migration.
Migration completes, but there are failed items
Click Download migration report and use the report to identify items that didn't migrate and the reasons for the failure. For details, go to Understand the new data migration service reports.
Fix the issues, then Run a delta migration.
Missing messages
If you have missing messages after a migration, work through the following troubleshooting steps.
Step 1: Make sure a message isn't mislabeled
- Get the message-ID of a missing message from the source account.
For details on finding the message-ID, go to Trace an email with its full headers.
- In the target account, use the rfc822msgid: Gmail search operator to search for the message-ID.
For details on using a search operator, go to Search operators you can use with Gmail.
- If the message can't be found, continue to the next step.
Step 2: Check the migration report
- Download the migration report.
- Search for the missing message using its message-ID.
- If the message shows as failed in the report, locate the error code in Common error messages.
- Follow the instructions to troubleshoot the error message.
Errors migrating labels
If you get an error when migrating labels, the message attached to the label also fails to migrate. To troubleshoot, you can:
- Fix the issue with the label. For details, go to Understand the new data migration service reports.
- Remove the label and run a delta migration.