OneDrive to OneDrive MIGRATION GUIDE

1. OneDrive to OneDrive migration with Cloudiway

Play Video
1.1. Performance & Security

For more security information, please refer to this article.

For more information about migration performance, please refer to this security article.

1.2. License Management

Cloudiway platform automatically assigns the licenses. For more details regarding the license management, check out this page.

1.3. Delta Passes

Delta migration is a Cloudiway functionality that allows you to migrate incrementally. Changes are migrated during delta passes. Deletions are not propagated. Learn more.

1.4. Support

Although we provide support for our products, we do not provide support for third-party products such as PowerShell or server administration of Microsoft or Google products.

2. OneDrive to OneDrive migration scope

2.1. What is migrated

You will find the list of what can be migrated from OneDrive on this page: File migration tool.

2.2. Migration considerations​

All data can be migrated without any changes to the source structure or permissions. Any users with permissions will need to be listed in a mapping table in order for their permissions to be migrated.

Important: the mapping table must be exhaustive, any missing email address will not be converted, and would end up with loss of file permissions and metadata. Cloudiway automatically populates this mapping table when source OneDrive accounts are discovered by Get List functionality. However, make sure if the mapping table was populated automatically that you are not missing any email address.

2.3 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. Pre-migration configuration

4. OneDrive to OneDrive Migration process

The oneDrive to OneDrive migration is a five step process:

  1. Connectors creation.
  2. User List management.
  3. Audit. This step is optional.
  4. Pre-Processing to recreate the OneDrives
  5. Migration.

For Cloudiway to migrate your files, it needs to be able to communicate with both your source and target domains. 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 Office 365 and target connectors.

There are a number of ways to manage your user list. You can:
  • import a CSV file .
  • Discover the users automatically.
  • Create  the users manually.
Option 1: 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.
Cloudiway User List Import
For more details on the syntax of the CSV file, you can read this article :How to Fill the User CSV file?
3. Click on the BROWSE button.
4. Locate your CSV file, and select it.
5. Select the appropriate connectors in the Source and Target fields
6. Click on the UPLOAD button If you see any error messages, check your CSV file, and try uploading again.
7. Once the CSV file format is correct, you will see a confirmation message.

Option 2: Get List
Cloudiway’s Get List tool helps you to retrieve users from your source tenant. Go to Migration, select Get List.
Cloudiway User

Select the source and target connectors.

Then specify:

  • OneDrive as Target Recipient Type.
  • 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.

You can monitor the progress of this task in the User List: Get List Logs.

Option 3: Create a single user

Click on MANAGE > Create User and enter the following details:

If you want to exclude different folders from the migration, enter the folder path.

Note: You don’t need the Folder ID to exclude a folder from OneDrive, you just need to enter the path.

The audit is optional and purely informative. It consumes the Cloudiway license. You do not have to run it, unless you wish to see how many files and folders you have in the source drive.

Cloudiway’s Audit tool builds a list of all OneDrive folders and their respective details.
 
You can use the audit results to decide whether you wish to migrate any folders. and if so, you can specify the document library for each folder to be migrated.
Within document libraries, folder structures are entirely recreated.

 

Remember, these folders with specific destinations would need to be migrated before the general migration because Cloudiway only migrates a file once. Therefore, any folders with alternative targets will take priority.

  1. From the User List area, select the users to audit (you can use the checkbox at the top of the list to select all, which we recommend)
Cloudiway User List Checkboxes

2. From the action bar, click on MIGRATION, then Audit, the status change to FileAudit Scheduled

Cloudiway ser List Audit

3. Refresh your page and verify the status

Cloudiway User List AuditStatusErrors

4. If there is an error, click on the file Error status, then Logs to see the Error message. Licenses are missing in this case; contact your sales representative or purchase more licenses on the platform, then try again.

Cloudiway User List AuditStatusError NoLicens

5. For updates, you can refresh the page. To watch the results, click on the FileAudit Success status, then Audit

Cloudiway Audit Result

Now that your Cloudiway connectors are set up, you can run the preprocessing task. The task can be run more than once if required. When OneDrive is both the source and target, the target admin account must have a valid SharePoint license. Otherwise, the OneDrive’s provisioning cannot proceed. The preprocessing task:

  • checks credentials (login details, App ID, App Secret, AppRealm) in the source and target;
  • provisions each OneDrive if it doesn’t already exist in the target; and,
  • grants permission to the admin user to access each OneDrive in the source and target.

1. From the User List area, select the users to preprocess (you can use the checkbox at the top of the list to select all)

2. From the action bar, click on MIGRATION, then PreProcessingthe status change to FilePreProcessing Scheduled

3. For updates, you can refresh the page, the status should be updated to success

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. Detailed article, here.

If you require more information, you can click on any of the files in the User List. You can Edit, see the Audit results, Logs, and Statistics.

5. OneDrive to OneDrive Migration Global Settings

6. Troubleshooting