This article provides instructions on configuring a migration batch for migrating users from Box to Google Workspace Shared Drives. The setup process outlined here focuses on migrating documents.
Before proceeding, ensure you have completed the steps in the Box to Google Workspace Migration Guide to set up your migration project and added your users batch.
Adding Items to Migrate
When preparing to migrate users to Shared Drives at the destination, follow the format below:
- Export Type: User
- Export Name: Source primary email address
- Import Type: Shared Drive
- Import Name: Destination Shared Drive name or ID
- Given Name: Not required
- Family Name: Display name of the destination Shared Drive
- Documents Path: ID of the source folder you wish to migrate from (Optional; this can be left blank if you plan to migrate from the root of the users Box account).
- Documents Destination Path: Name of the folder you wish to migrate to at the destination (Optional; this can be left blank if you plan to migrate to the root of the destination Shared Drive).
For each user entry, select the specific items you wish to migrate. Make sure the 'Migrate' option is enabled for all users included in the migration.
General Settings
In the General Settings section, ensure all domain mappings are configured correctly to facilitate replacing the source domain with the destination domain during the migration.
You can also apply date range filters for various data types to migrate information within a specific timeframe. Specify the date ranges you wish to include.
Source Settings
For a standard user-to-user migration, it is recommended to keep the source settings at their default values. However depending on your migration scenario, you may wish to adjust some settings. Detailed information about each source setting can be found in the below article.
Destination Settings
For this type of migration, you will need to consider the below settings.
- Shared Drive -> Shared drive file permissions: Set this to "File" to ensure Box file permissions are replicated in the destination Shared Drive.
- Shared Drive -> Shared drive folder permissions: Set this to "Folder" to ensure Box folder permissions are replicated in the destination Shared Drive.
- Shared Drive -> Shared drive default managers: Provide a list of valid user email addresses to assign as destination managers. Please note, group email addresses are not permitted. These default managers will be assigned temporarily during the migration to optimize performance and will be removed upon completion if the "Remove Shared Drive Default Managers" option is enabled.
- Shared Drive -> Remove shared drive default managers: Remove the shared drive default managers specified in 'Shared drive default managers' field.
- User -> Create users/resources/groups/shared drives: Enabling this will ensure Migrate creates any Shared Drives that do not already exist at the destination.
For a detailed explanation of each destination setting, please refer to the article below.
Google Workspace - Destination Settings
Advanced Settings
For a straightforward user-to-user migration, most advanced settings can remain at their default values. However, consider the following:
-
Address Replacement: It is highly recommended to upload an address replacement CSV that maps source users to their corresponding destination users. This ensures permissions are correctly migrated. For more information, please refer to the Address Replacements article.
Migration Process
The migration process will vary depending on your project's specific approach. Generally, it is advisable to start with a bulk migration and perform delta migrations closer to the final migration cutover date.