File Server (Home Directories) to OneDrive For Business 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 () in the top navigation bar of MSPComplete, and select the appropriate migration product.
This Migration Guide provides the procedures to be followed for migrating
directories from File Servers to OneDrive for Business.
This strategy is only recommended when migrating a small number of home directories. When migrating a larger number of home directories, PowerShell scripts and a CSV file can automate the process. Refer to
KB005488 for step-by-step instructions, and to obtain the scripts and CSV file.
When migrating file shares from the file server, follow the migration guide specific to that scenario. Typically, file shares will be migrated to SharePoint Online Site libraries.
The diagram below provides a high-level overview of the steps involved in migrating a small number of home directories. The key difference for this type of migration scenario is that this requires an Azure subscription, and the use of the BitTitan UploaderWiz utility to upload the home directories to Azure before they can be migrated into the OneDrive for Business accounts using MigrationWiz.
Buy an Azure subscription (or use the
free one-month trial, and be aware that this option is only viable if you are performing a very small migration).
Create an Azure storage account, and take note of the Storage Account Name and the Primary Access Key. (In Azure, from the storage screen, click on
Manage Access Keys at the bottom of the screen.) These need to be entered into the MigrationWiz document project, when specifying the Source settings. We recommend that you create an Azure Storage Account in the same Microsoft data center as the Destination Office 365 tenant. There is no need to create any Azure containers for this migration. Separate containers are created on a per-home directory basis. During migration, MigrationWiz will create two separate metadata files (with extensions: -directory.metadata and -files.metadata) which will be added to each container. These are used during migration by MigrationWiz, to build the folder structure in OneDrive for Business and to migrate the permissions. They should not be deleted until after the migration.
Notes: If there are problems with the upload, and you need troubleshooting help, refer to
KB005473.If performing these steps from a domain-joined computer, a network drive needs to be mapped from the domain-joined computer to the file server, and the rootpath needs to match this drive letter, followed by the directory path - e.g., "x:\home directories" (if spaces in the path then need to surround the path by quotes) or x:\homedir.