- This is the complete onboarding task flow for migrating folders and documents from Google Drive to OneDrive for Business.
- Complete each step in order. Links to corresponding Knowledge Base articles are provided.
- The Source must be a paid version of Google Drive. Free Google Drive accounts are not a supported Source.
- The Destination must be OneDrive for Business, not the personal version of OneDrive.
- Watch the Video: Google Drive to OneDrive for Business Migrations before performing your migration. The video provides an overview of Google Drive to OneDrive for Business migrations; it shows the Prepare the Source Environment steps to set up Google OAuthentication access, and also shows the MigrationWiz steps.
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 a 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? for more information.
- Make sure there are no spaces before or after the scope entry. This will cause the authorization to fail.
- Enable API Access. Log in to the Google Admin portal > Security > API Reference > checkmark the Enable API Access button. Note: This extra step is mandatory when migrating from Google Drive.
- Export mailboxes to CSV file(s). From the Google Admin portal > Click Users > Click ⁝ (3 vertical dots) > Download Users > Download All Users > Click OK > Save.
Prepare the Destination Environment
- Create an administrator account in Office 365 to be used for migration, or use the global admin account for the tenant. Read the How do I create an administrator account in Office 365, and then use this during migration? for more information.
Important: The admin account must have a full license assigned to it, in order to be able to provision OneDrive for Business profiles for each user during the migration process. Read the Personal Site is not instantiated = PermissionsUserNotLicensed article for more information.
- Assign a SKU license that contains OneDrive for Business to the admin account that will be used for migration.
- If users have never used OneDrive before, MigrationWiz will provision OneDrive (SharePoint) profiles for each user being migrated, using the admin account credentials that are entered in the MSPComplete Destination endpoint. However, it does not create the user account; the user account needs to have already been created.
- MigrationWiz cannot provision a OneDrive profile for blocked users. If a user is blocked, there will be a provisioning or access error.
- Manually, one at a time.
- By bulk import, via CSV file. Read the Add several users at the same time to Office 365 article from Microsoft for more information.
Note: You can use the CSV file that was created under Step 3 of the Prepare the Source Environment section of this guide.
- By PowerShell script. Read the Create user accounts with Office 365 PowerShell article from Microsoft for more information.
- By DirSync, AAD Sync or AAD connect. Read the How do I synchronize my Azure Active Directory objects to Office 365? article for more information.
- Important: If you are migrating permissions, the part of the usernames before the "@" sign on Office 365 must match the part of the username on Google Drive before the "@" sign, e.g., firstname.lastname@example.org on Google Drive must follow the same format before the @ sign on Office 365, and so must also equal "john.smith" on Office 365. The domain name, however, can be different. Read the How are shared documents handled when migrating documents? article for more information.
- Create the customer. Read the Add Customers article for more information.
- Create the Source and Destination endpoints. Read the View, Add, and Edit Customer Endpoints article for more information.
- For the Source endpoint:
- Click EndPoints > Add Endpoint > Enter endpoint name > For endpoint type, select Google Drive.
- Enter the Google admin account email address and domain name in the appropriate fields.
- For the Destination endpoint:
- Click EndPoints > Add Endpoint > Enter endpoint name > For endpoint type, select OneDrive for Business. Note: Do not select the endpoint named OneDrive Pro for Business V2. That endpoint is used for other migration scenarios, and does not support the moderate mode MigrationWiz Advanced Option, which is important for this migration scenario. Read the New SharePoint Online and OneDrive for Business Azure Migration Endpoints article for more information.
- Enter the administrator username and password, for the admin account that was set up under Step 1 of the Prepare the Destination Environment section of this guide.
Important: The domain name of the admin account must match the domain name of the user accounts that will be added to the project in MigrationWiz. Otherwise, the OneDrive for Business profiles cannot be created during migration, and permissions will not be migrated. For example, do not add the admin account with the onmicrosoft.com domain name if the users will be entered with a vanity domain name.
- 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 (OneDrive).
- 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 (5) 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, 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.
- IncreasePathLengthLimit=1 - Use this Advanced Option in MigrationWiz to enable the use of 400 characters for the file path name. Read the What would I use the Advanced Option IncreasePathLengthLimit=1 for? 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.
- ShrinkFoldersMaxLength=200 (optional, but recommended) Read the How do I auto shrink the folder path when migrating to OneDrive for Business or SharePoint Online? article for more information.
- DocumentBrowsingMode=Moderate (optional, but recommended) Read the How does Google Drive to Microsoft OneDrive for Business with Moderate Mode work? article for more information.
- RenameConflictingFiles=1 (optional, but recommended). Read the Error: Cannot create 'filename' because another file exists with the same name 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 detailed 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 are already using Office 365).
- Customize 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 500 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 the Start button > From the drop-down list, select Full Migration > Click the Start Migration button. Read the How do I start a migration? article for more information.
- For large migration projects that have more than 500 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 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 Start Migration. Read the How do I start a migration? article for more information.
- Full (Delta) pass: Select the users > Click the Start button from the top, select Full Migration > Click Start Migration. Read the How do I start a migration? article for more information.
- 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 migration completion. Assist them with setting up access to their OneDrive for Business accounts, and setting up their synchronization settings.
- Provide training on OneDrive for Business.