Increase the success of your migration by following these recommended best practices for Google Workspace Migrate.
- Adhere to the system requirements—Migrations require many resources. Meeting or exceeding the system requirements is crucial because new resources cannot be provisioned while a migration is in progress. Learn more
- Use Google Cloud Console—Google extensively tested Google Workspace Migrate on Cloud Console. We have the most experience supporting migrations in Google Cloud, including provisioning of the network and VMs to the required specifications.
- Reduce network latency—To improve network performance, connect the servers on the same network and situate them in close physical proximity.
If you use Google Compute Engine inside Google Cloud, you might want to choose a country/region or zone that is close to your point of service to decrease network latency. For example, choose the primary country/region or zone closest to your data sources.
- Set Chrome Browser as the default—Both Google Workspace Migrate and Google Cloud have been extensively tested on Chrome Browser. Learn more
- Turn off automatic Microsoft Windows updates—To prevent an unintended restart of your servers during a migration, manage Windows updates outside of running migrations.
- Set up the correct number of worker nodes—The number of worker node servers deployed should match the number of users in your organization and the amount of data to migrate. The size and complexity of your migration phases should match your organization's goals to ensure you have provisioned enough nodes to meet them. Learn more
- Limit worker nodes to 40 per cluster—For large migrations, the maximum number of worker nodes is 40. These 40 nodes combine to create a cluster. You can deploy multiple clusters for a migration. Learn more
Note: Clusters are self-contained and do not share databases, nodes, or platforms. Therefore, migration data sets on different clusters should be as mutually exclusive as possible.
- Set up the correct digital certificate—Google Workspace Migrate uses TLS certificates as its cryptographic protocol. TLS is used to set up the Google Workspace Migrate platform and node servers. Google does not currently support self-signed certificates. Learn more
Plan your migration
- Scan your data—We recommend a full data scan before a migration. A full scan runs faster than a migration and it provides the following benefits:
- Reports with an estimation of the corpus size, the type of source data, and any issues with the data.
- Optimization of workload distribution across worker nodes.
- Prioritization of large individual data sets that require serial processing (such as users with extensive numbers of emails). In turn, large data sets do not become migration bottlenecks.
- Set up a new project when you’re ready to migrate data—Reusing a test project can cause data to be skipped if it was previously migrated in a test phase. Google Workspace Migrate recognizes that the data has already been migrated and doesn’t migrate it again. After you complete testing, use a new project to avoid this issue.
- Don't map a single source user to multiple target users within the same project—Doing so can result in unexpected migration outcomes. If you must map a single user to multiple target users, use separate Google Workspace Migrate projects for each mapping.
When migrating files to Google Drive, we recommend you:
- Familiarize yourself with the guidelines in Google Drive large migration best practices.
- Split the migration into multiple target locations, for example, My Drives belonging to different users or separate shared drives.
- If possible, specify multiple Drive users in your mapping. It spreads the load of the migration across a larger group of users and helps avoid quota issues.
- Migrate to shared drives so that all team members can access your organization’s resources. For details, go to Best practices for shared drives.
- Combine multiple user shares into Google Groups to easily manage shared drive membership and communicate announcements to a group.
- Eliminate folder hierarchies where possible.
There are some limits to the size and types of data you can store in Drive. For details, go to Files you can store in Google Drive.
Review the watchpoints for your data source:
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.