- This is the complete onboarding task flow for migrating folders and documents from Google Drive to Dropbox.
- Complete each step in order. Links to corresponding Knowledge Base articles are provided.
Prepare the Source Environment
- Enable OAuthentication 2.0 within your Google admin portal, to grant MigrationWiz access to G Suite. Read the Enable access to G Suite using OAuth 2.0 article for more information.
- If you are migrating from multiple domains, repeat these steps for each domain.
- Under Authorized API clients > Client Name > Enter: 118005701438129985126
- Under One or more API Scopes, enter the scope for G Suite as Source (read-only scopes):
https://mail.google.com/, https://www.google.com/m8/feeds, https://www.googleapis.com/auth/contacts.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/admin.directory.group.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/drive, https://sites.google.com/feeds/
- OAuth administrative credentials will not function properly with G Suite for Business Legacy free accounts. If a G Suite tenant is a G Suite for Business Legacy free account, end user credentials must be used. Read the How do I migrate from or to G Suite using end user credentials? article for more information.
- Make sure there are no spaces before or after the scope entry. This will cause the authorization to fail.
Prepare the Destination Environment
- Create the Dropbox Business account and purchase Dropbox licenses.
- Create a Dropbox user account that will be used for the migration, and grant this account appropriate team admin privileges. Follow the instructions in the Add Tiered Admins guide from Dropbox.
- Use the list created under Step 3 of the Prepare the Source Environment section of this guide to recreate users in the new Dropbox Business account. Follow the instructions in the Invite your Team guide from Dropbox.
Note: Users must accept the invitations before their accounts are created at Dropbox. You must wait for the team to accept the invitations before starting the migration, or the migration will fail.
- Create the customer. Read the View, Add, and Edit Your Customers article for more information.
- Create the Google Drive and Dropbox endpoints. Read the View, Add, and Edit Customer Endpoints article for more information.
- For the Google Drive endpoint, select Google Drive as the endpoint type, and enter the Google admin account email address and domain name in the appropriate fields.
- For Dropbox, select Dropbox as the endpoint type, and select Provide Credentials.
- Under this endpoint type, there are no fields to enter admin account and password.
- There will be an API Authorization Request screen prompt when you set up your MigrationWiz project later in the process.
- Create the Document Migration project. Read the How do I set up a document migration project in MSPComplete? article for more information.
- Create the Document Migration project > Select the customer > Select the Source endpoint (Google Drive) > Select the Destination endpoint (Dropbox). At the Authorization tab, click on the Request Access Token button. Within the Dropbox - API Request Authorization page, enter the email address and password for the Dropbox admin account, and click on the Allow button on the next screen.
- Set the value for maximum licenses to consume per item, per pass. The default value is one license per user, which allows up to 10GB to be migrated per user. However, if a user has 28GB of data, the migration will pause at 10GB, and you will have to assign more licenses to the user. The recommended maximum number of licenses to consume per user for a document migration project is five licenses per user, which allows up to 50GB of data to be migrated per user. The project will only consume the number of licenses for the amount of data migrated. If a user has 28GB of data, then only three out of the five licenses will be consumed, and two licenses will remain. Read the View and Purchase Licenses article for more information.
- Under Support/Support Options add:
- InitializationTimeout=28800000 - This increases the initialization timeout window to eight hours. Read the Cannot get folders from My Drive article for more information.
- FolderLimit=20000 - This increases the maximum number of folders for the migration to 20,000. Large companies might have more than 10,000 folders (the default) to migrate, so we recommend increasing the folder limit to 20,000. Read the How do I increase the folder limit for document migrations? article for more information.
- RemoveExistingPermissionsWhenUnspecified=1 Read the What is the Advanced support option RemoveExistingPermissionsWhenUnspecified=1, and when should it be used? article for more information.
Note: There are no spaces on either side of the "=" sign, and the entries are case-sensitive, so pay special attention to the capital letters in the commands above.
- Set the Advanced Option to send a notification to end users after the migration pass completes.
- Notifications > Send successful migration and notification to: > Source email address (if users are still using G suite Gmail) or Destination email address (if users have already migrated from the G Suite gmail platform).
- Customize the notification email. Checkmark the Customize "successful migration" email box. Add your own customization text and company name to this email.
- Note: Notifications should only be set up before the final pass. If performing a single, Full pass, set this up now. If you are following a Pre-stage migration strategy, only set this up prior to the final Full (Delta) pass.
- For small- to medium-sized migration projects that have less than 250 users, we recommend a Big Bang Migration strategy. This is a single, Full pass migration.
- Steps for a Full Migration pass:
- Select the users > From the top navigation, click on the Start button > From the drop-down list, select Full Migration > Click on the Start Migration button. Read the How do I start a migration? article for more information.
- For large migration projects that have more than 250 users, we recommend a Pre-Stage Migration strategy. This is a multiple-pass migration.
- Steps for a Pre-Stage Migration:
- Pre-Stage pass: Select the users > Click on the Start button from the top, and select Pre-Stage Migration > Under the Migration Scheduling section, from the drop-down list, select 90 days ago > Click on Start Migration. Read the How do I start a migration? article for more information.
- Full (Delta) pass: Select the users > Click on the Start button from the top, select Full Migration > Click on Start Migration. Read the How do I start a migration? article for more information.
- Important: Recent changes to the Dropbox APIs prevent us from adding watermarks on files in the Destination Dropbox accounts. Therefore, if you perform a partial migration, reset the items in MigrationWiz, and then perform the migration again, you will end up with duplicate files at the Destination. If you must rerun the migration, we recommend that you first delete all files already migrated to the Destination Dropbox accounts.
- To prevent users from inadvertently logging in and using their Google Drive accounts, decommission the Google Drive user accounts, or change their passwords.
- Notify users once the migration has completed. Note: If you set the MigrationWiz Advanced Option for Notifications, they will receive an email upon completion of the migration. Assist them with setting up access to their Dropbox accounts.
- Provide training to end users on Dropbox.