Prepare the Source Environment
- Create a OneDrive for Business user account that will be used for the migration, and give it main global administrator privileges or use the existing global administrator account that was set up at the time the Office 365 tenant was created. KB004948
Note: We highly recommend that you use an administrator account that isn’t one of the users being migrated. Otherwise, it can cause issues with missing shared permissions.
- Export the list of OneDrive for Business user accounts to a CSV file. This can be used when adding users on the Destination, and when adding users into your MigrationWiz project dashboard. KB004519
Prepare the Destination Environment (Google Drive)
- Grant MigrationWiz OAuth2.0 access to authenticate to Google Drive. KB005019
Note: G Suite as the Destination (full 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/
- Add users to Google Drive. The instructions are located here.
- Create the customer. KB005421
- Create the OneDrive for Business and G Suite endpoints.
- Click on EndPoints > Add Endpoint > Enter endpoint name > For endpoint type, select OneDrive for Business. Enter the global admin account and password in the appropriate fields.
- For the Destination endpoint:
- Click on 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.
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. KB005070
Add the accounts (also referred to as "items") that will be migrated to the project. KB004842
Set Project Advanced Options. KB004834
- Create the Document Migration project > Select the customer > Select the Source endpoint (OneDrive for Business) > Select the Destination endpoint (Google Drive).
- InitializationTimeout=28800000 - This increases the initialization timeout window to eight hours. KB005099
- 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. KB005557
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.
Run Verify Credentials. KB004511
Purchase Document Migration licenses. KB004647
Notify users that a migration is occurring. Send email to all users telling them the time and date of the migration. During this time, they should not modify any documents in their OneDrive for Business accounts, because any modifications will not be included in the migration.
Perform the migration using one of the following strategies:
- 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 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, then only three out of the five licenses will be consumed, and two licenses will remain. KB004890
- Under Support/Support Options add:
- 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. KB004938
- 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. KB004938
- Full (Delta) pass: Select the users > Click on the Start button from the top, select Full Migration > Click on Start Migration. KB004938
Click on the pie chart icon in the MigrationWiz dashboard to receive an email containing all the project migration statistics. KB004626
- 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.
- For large migration projects that have more than 500 users, we recommend a Pre-Stage Migration strategy. This is a multiple-pass migration.
To prevent users from inadvertently logging in and using their OneDrive for Business accounts, decommission the OneDrive for Business user accounts, or change their passwords.