Skip Ribbon Commands
Skip to main content

OneDrive for Business to OneDrive for Business Migration Guide

Last Update: 7/21/2017 11:29 AM
This article has been moved to our new Help Center. Please update your bookmarks.
OneDrive for Business to OneDrive for Business Migration Guide

Important: When you sign in to MigrationWiz, you are redirected to the Getting Started page in MSPComplete. To go to a migration project created before April 4, 2017, click the Go to Projects button on the Getting Started Page. To create a new project for the migration scenario documented in this article, go to the Delivery Center and add an Doc: OneDrive for Business to OneDrive for Business​ service to the customer. Read the Delivery Center article for more information about adding services to a customer.

Introduction

  • This is the complete onboarding task flow for migrating folders and documents from OneDrive for Business to OneDrive for Business.
  • Complete the steps in order. Links to corresponding Knowledge Base articles are provided.
  • The Source and Destination must be OneDrive for Business - not the personal OneDrive version.

  • If you are migrating to an Office 365 Small Business Tenant account, the processes will be very similar. However, you will not be able to use admin credentials for your Destination endpoint, and will, instead, be using end user credentials.​ KB004886.

Prepare the Source Environment

  1. 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.
  2. 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

  1. Create an administrator account in Office 365 to be used for migration, or use the global admin account for the tenant. KB004948 Important: The admin account must have a full license assigned to it, in order to be able to provision OneDrive profiles for each user during the migration process. KB005537
  2. Set up accounts on Office 365 and assign licenses. These can be created in several ways:

    • Manually, one at a time.
    • By bulk import, via CSV file. Microsoft instructions
    • By PowerShell script. TechNet article
    • By DirSync, AAD Sync or AAD connect. KB004336
    • Notes:

      • MigrationWiz will provision a OneDrive (SharePoint) profile for each user being migrated. However, it does not create the user accounts; they should already have been created.

      • MigrationWiz cannot provision a OneDrive profile for blocked users. If a user is blocked, this will result in a provisioning or access error.

    Important: If you are migrating permissions, the part of the username before the "@" sign on the Destination must match the part of the username on the Source before the "@" sign. For example, john.smith@domain1.com on  the Source must follow the same format before the "@"sign on the Destination, and so must also equal "john.smith" on Destination. The domain name, however, can be different. KB004843

  3. Set up groups on Office 365. If permissions were assigned to groups on the Source, and you want these to be migrated, the group names on the Destination must match the group names on the Source. KB004843

MSPComplete Steps

  1. Create the customer. KB005421
  2. Create the Source and Destination endpoints. KB005427
    • ​​For the Source endpoint:
      • Click on EndPoints > Add Endpoint > Enter endpoint name > For endpoint type, select OneDrive for Business.
      • Click on the Provide Credentials radio button, and enter the administrator username and password in the fields.
    • For the Destination endpoint:

      • Click on EndPoints > Add Endpoint > Enter endpoint name > For endpoint type, select OneDrive for Business.
      • Click on the Provide Credentials radio button, and enter the administrator username and password in the fields.
    • Important: If the .onmicrosoft.com domain name was entered for the administrator credentials when creating the endpoints, rather than the vanity domain name, this must also be used when adding users. If each user's alias contains the .onmicrosoft.com domain name, this is also acceptable.
  3. ​Purchase licenses. From your MSPComplete dashboard, click Purchase > Document Migration > select MigrationWiz-Document and enter the number of licenses you wish to purchase.

    Note: Check to see if there are any available bundles for discounts (e.g., MigrationWiz-Mailbox and Document bundle).  KB004647

MigrationWiz Steps

  1. Create the Document Migration project. KB005070
    • Create the Document Migration project > Select the customer > Select Source endpoint > Select Destination endpoint.

  2. Add the accounts (also called "items") that will be migrated to the project. Note: If you are using the Bulk Add option, only the Source and Destination columns need to be filled in. You can use the CSV file that was created under Step 2 of the Prepare the Source Environment section of this guide. KB004842
    • Important: If the .onmicrosoft.com domain name was entered for the administrator credentials when creating the endpoints, rather than the vanity domain name, this must also be used when adding users. If each user's alias contains the .onmicrosoft.com domain name, this is also acceptable.  
  3. Set Project Advanced Options. KB004834
    • 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:
      • 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.
    • 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 the original Source Office 365 tenant) or Destination email address (if users are already using the Destination Office 365 tenant).
      • 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.
  4. Run Verify Credentials. KB004511
  5. Notify users that a migration is occurring. Send email to all users letting them know the time and date of the migration. During this time, they should not modify any documents in their Source OneDrive accounts, because any modifications will not be included in the migration.
  6. Perform the migration, using one of the following strategies:
    • 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 on the Start button > From the drop-down list, select Full Migration > Click on the Start Migration button. KB004938
    • 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 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
  7. Click the pie chart icon in the MigrationWiz dashboard to receive an email containing all the project migration statistics. KB004626

Post-Migration Steps

  1. To prevent users from inadvertently logging in and using their Source accounts, decommission their Source OneDrive for Business user accounts, or change their passwords.
  2. 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.