BOX TO ONEDRIVE MIGRATION
1. Box to OneDrive migration with Cloudiway
This guide shows you how to migrate your content from Box to OneDrive for Business.
Before we start describing the step by step process, here are few main information that are common to all type of scenario migration.
Performances
When migrating from Box to OneDrive, you must carefully take care of performances potential issues. Several criteria may impact performances:
Data size: The amount of data being migrated can impact performances. The number of files and number of folders will also impact the number of calls to perform and therefore the overall performances.
Throttling: Microsoft 365 has built-in throttling mechanisms to protect his infrastructure.
For more information about migration performance, please refer to this article.
Security
Cloudiway platform is highly secure and is ISO 27001 certified.
Full information regarding the security is available in our security ebook.
Licenses
You need to purchase Cloudiway File Migration Licenses.
Cloudiway platform automatically assigns the licenses. For more details regarding the license management, check out this page.
Delta Passes
Delta pass migration is a functionality that allows you to migrate incrementally. Changes (except deletions) are propagated during delta passes.
More information about delta pass mechanism: Box To OneDrive delta pass mechanism.
Support
Although we provide support for our products, we do not provide support for third-party products such as server administration, Box administration or Microsoft products.
Our support will share you the documentation for perfoming the administration tasks but will not do it for you.
Before starting your Box To OneDrive migration, you must be able to setup both Microsoft 365 and Box yourself. Don’t hesitate to contact our Sales team if you want to engage our Consulting services for these tasks.
2. Box to OneDrive migration scope
What is Migrated?
You will find the list of what can be migrated from Box on this page: File migration tool.
Box to OneDrive Migration Considerations
Cloudiway uses a mapping table to translate email addresses found in permissions and metadata.
Ensure that you are filling the mapping table correctly and entirely before your start any migration.
The following article provides more information about the mapping table.
Audience
This guide is aimed at experienced system administrators who are capable of connecting to remote systems and using a variety of administration tools.
If you are concerned you might have any difficulty completing these steps, please consider a solution with our consulting team. This will ensure a fast, cost-effective, and stress-free implementation.
3. Box to OneDrive migration prerequisites
Before you start
Before you start, you will need to ensure you have the details outlined in the following table.
| Name | Description | Location |
| Cloudiway login | Stores details and provides communication between the systems you already use. | https://portal.cloudiway.com |
| Help center | Our extensive help center is always accessible, with videos, troubleshooting tools, samples and more. | https://help.cloudiway.com |
Box Admin
| To configure the Box token and permissions. | https://www.box.com |
SharePoint Administrator Account
| It has to be the primary SharePoint administrator. | We recommend you create a migration account, especially for migration. After all migrations are complete, simply delete this account. We provide the steps below to help you set up an account if you don’t already have one. |
| Mapping table and User List (CSV) | Prepare any mapping tables in CSV format, and User List, ready to upload later on. |
|
Source Prerequisites
You need a Box global admin account in order to be able to create and configure the permissions that are required for the connector.The next chapter explains how to create the Box connector and configure its permissions.
Target Prerequisites
An Azure Active Directory (Entra ID) application needs to be installed on the Microsoft 365 tenant. Tenant Administrator credentials are required for this setup.
The next chapter explains how to create the Microsoft 365 connector and configure its permissions.
4. Box to OneDrive migration process
The Box to OneDrive Migration is a five step process :
- Create the connectors. They will be used to connect to Box and OneDrive .
- Manage the User migration list.
- Run an Audit. This step is optional.
- Run a Pre-Processing to pre-create the target OneDrives and migrate the permissions.
- Run the migration.
4.1 Create your connectors
Box to OneDrive migration requires to communicate with both your source and target tenants.
To do this, Cloudiway uses connectors. You will need to set up a connector for each source tenant you wish to migrate and each target tenant that files should be migrated to.
Follow the steps from this page to configure your Box and Microsoft 365 connectors.
In particular see :
- This article for creating your Box connector
- This article to create a Microsoft connector and register your Azure AD Application
4.2 Create your User List
you can manage the migration list:
- Manually.
- through the discovery.
- by importing a CSV file.
Option 1: Create a user manually
Click on MANAGE > Create User and enter the following details:
Option 2: Get List
Run the discovery process. It will fill the Box to OneDrive migration list.
From the Migration menu, select Get List.
Enter the Source and Target Pool.
Then specify:
- The Target Recipient Type: Shared Drive
- The Matching Rule:
- Mail Exact Match: the source email = the target email (bob.marley@sourcedomain.com > bob.marley@sourcedomain.com)
- Keep Email Prefix Same as Source: only the domain name changed (bob.marley@sourcedomain.com > bob.marley@targetdomain.com)
- FirstName.LastName (i.e. bob.marley@targetdomain.com)
- F.LastName (i.e. b.marley@targetdomain.com)
- FLastName (i.e. bmarley@targetdomain.com)
- LastNameF (i.e. marleyb@targetdomain.com)
- The Target Domain.
Click On Get User List. Once the Get List job is completed, the list of users will appear in the User List.
Option 3: CSV File Import
If you have a CSV file of all your users, you can upload the file to Cloudiway.
1. Navigate to Files > User List
2. Click on Manage on the action bar and select Import
3. If required, click on Download sample CSV and add your users to the CSV file.
This article explains how to fill the CSV file.
4. When you have a complete CSV file with the correct headers, click on the BROWSE button.
5. Locate your CSV file within your own file system, and select it.
6. Select the appropriate connectors in the Source and Target fields.
7. Click on the UPLOAD button
If you see any error messages, check your CSV file, and try uploading again.
8. Once the CSV file format is correct, you will see a confirmation message.
4.3 Audit your drives
The audit is optional and purely informative.
You can run an audit. That will help you determine the size of your drives.
1. From the User List , select the users to audit.
2. From the action bar, click on MIGRATION, then Audit, the status change to FileAudit Scheduled
3. If there is an error, click on the line to edit the entry. In the Logs tab, check the Error message in the logs. Licenses are missing in this case; contact your sales representative or purchase more licenses on the platform, then try again.
4. To check the result of the audit, edit the line and then click on the Audit tab;
4.4 Preprocessing
When your Cloudiway connectors are set up, you are ready to perform your Box to OneDrive Migration. Before launching the migration, you need to run the preprocessing task at least one time. This task can be run more than once if required. The preprocessing task will precreate the OneDrives and set the permissions to the migration account.
- From the User List area, select the users to preprocess (you can use the checkbox at the top of the list to select all)
- From the action bar, click on MIGRATION, then PreProcessing, the status change to FilePreProcessing Scheduled
Periodically refresh the pages to update the status.
4.5 Migrate
Now that you have performed all the pre-migration steps within your tenants and Cloudiway, you’re ready to migrate. We recommend you run a test migration on a single user first to check that your configuration produces the outcome you expect.
To start your migration, select the users or batch and click on MIGRATION, then Start button. Your batch will be scheduled and will begin as soon as resources are available.
Don’t forget that Cloudiway migration platform supports delta passes and that migrations are therefore incremental.
Every time you restart the migration, only items that haven’t already been copied to the target — or that have been changed since they were copied to the target — will be migrated.
You can monitor your migration from the dashboard.
If you require more information, you can click on any entry in the User List and navigate to the Audit , Logs, or Statistics.
5. Migrate to specific folder
It is possible to split and reorganize your content.
In particular, you may want to migrate only specific folders or to migrate content to a specific folder. You can refer to the following article to determine how to configure the migration platform for these specific scenario:
https://help.cloudiway.com/article/how-to-migrate-files-from-or-to-a-specific-folder/
5.1 Exclude folder
If you want to exclude different folders from the migration, enter the Folder ID or Folder Path.
You can get the Folder ID from the URL, you don’t need to enter the Folder Path:
6. Box Migration Global Settings
Global settings are fully covered in this article:
Migration Global Settings
7. Troubleshooting
Cloudiway provides an extensive help center with many resources, including common error messages, video guides: https://help.cloudiway.com/
The help center also contains information on how you can ask for further support, should you require it.
If you didn’t find a response in this admin guide neither the help center, you could send a ticket from the HELP menu, then Support.
Additional resources:
