Skip Ribbon Commands
Skip to main content

OneDrive for Business to Dropbox Migration Guide

Last Update: 7/21/2017 11:33 AM
This article has been moved to our new Help Center. Please update your bookmarks.

​​OneDrive for Business to Dropbox Migration Guide

Important: When you sign in to MigrationWiz, you are redirected to the Getting Started page in MSPComplete. To get 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, click the waffle icon (waffle.png) in the top navigation bar of MSPComplete, and select the appropriate migration product.

Introduction

  • This is the complete onboarding task flow for migrating folders and documents from OneDrive for Business to Dropbox.
  • Complete each step in order. Links to corresponding Knowledge Base articles are provided.

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.
  2. Export the list of OneDrive for Business user accounts to a CSV file. This can be used when adding users to Dropbox, and when adding users into your MigrationWiz project dashboard. KB004519

Prepare the Destination Environment

  1. Create the Dropbox Business account and purchase Dropbox licenses.
  2. 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.
  3. Use the list of OneDrive for Business user accounts in the CSV file, to recreate them 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.

MSPComplete Steps

  1. Create the customer. KB005421
  2. Create the OneDrive for Business and Dropbox endpoints.
    • For the OneDrive for Business endpoint, select OneDrive for Business as the endpoint type, and enter the global admin account and password in the appropriate fields.
    • For Dropbox, select Dropbox as the endpoint type, and select Provide Credentials.

Notes:

      • 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.  KB005427

MigrationWiz Steps

  1. Create the Document Migration project. KB005070
    • Create the Document Migration project > Select the customer > Select the Source endpoint (OneDrive for Business) > Select the Destination endpoint (Dropbox). At the Authorization tab, click on the Request Access Token button. On the page entitled 'Dropbox  -API Request Authorization', enter the email address and password for the Dropbox admin account, and click on the Allow button at the next screen.
  2. Add the accounts (also referred to as "items") that will be migrated to the project. KB004842
  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 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.
  4. Run Verify Credentials. KB004511
  5. Purchase Document Migration licenses. KB004647
  6. 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.
  7. Perform the migration using one of the following strategies:
    • For small migration projects that have less than 50 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 50 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
  8. Click on the pie chart icon in the MigrationWiz dashboard to receive an email containing all the project migration statistics. KB004626

Post-Migration Step

To prevent users from inadvertently logging in and using their OneDrive for Business accounts, decommisson the OneDrive for Business user accounts, or change their passwords.