Chat now with support
Chat with Support

On Demand Migration Current - Administrator Guide

About On Demand Migration Before You Start Working with On Demand Migration Starting Migration Project Configuring Connections Sharing Availability Information Collecting Account Information Pre-Migration Assessment Account Migration Domain Coexistence Mail Migration OneDrive Migration Resource Processing Public Folders Migration SharePoint Online Migration Microsoft Teams Migration Finalizing the Migration

SharePoint Online Migration Project Dashboard

# Control  
Breadcrumbs Keep track of your location within project and quickly return to the previous steps.

Configure, manage, and control every aspect of the SharePoint migration project. Match and migrate site collections, monitor and troubleshoot the project with Events, and control the flow of the migration with Tasks.

Notification area Action items, alerts, tips, tricks, and other notifications are displayed in this area.
Action pane Set up and fine tune the migration with these commands.
site (previously site collections) widget See the summary on site (previously site collections) and quickly navigate to the list of site collections
Tasks widget See the status summary for the current migration flow and quickly navigate to all tasks
Errors widget

See the summary on warnings and errors and quickly navigate to all migration events



  • It is highly recommended to match / migrate all accounts in the corresponding Migration project to ensure that membership and content ownership are processed correctly.
  • The target tenant should already have the fully configured SharePoint Online with the active license plan. Note, that licenses are not automatically assigned to the target users during the migration.
  • Consents already get granted for source and target tenants.
    The following admin consents should be granted for SharePoint Online migration feature:
    • Migration - Basic,
    • Migration - Resource Processing for SharePoint

In case necessary admin consents are not granted or expired, discovery will be disabled and the following notification will be displayed: Grant admin consent to the Migration module on the Tenants page for both source and target tenants: Basic and Process Resources for SharePoint. To grant admin consents open Tenants page and grant necessary permissions to allow the product to access the source tenant and the target tenant. You will be redirected to the Microsoft web site for granting admin consent. Once admin consent is granted, you can start discovering site collections.

Discovering Sites

Before proceeding with the migration, discover all site collections (top-level sites) in the source tenant. The discovery process enumerate all sites and retrieves the relevant data. Once the discovery task is complete, you will see the sites summary on the SharePoint Online Migration Project Dashboard and all sites will be shown in the Site Collections list.

  1. Click Discover Site Collections on the project dashboard to create a new discovery task.
  2. Schedule when the task will be started. See Task Scheduling for details. Click Next to view the task summary.
  1. Check scheduled start of the task and name the task. Click Finish to save or start the task depending on schedule option selected.

TIP: Give informative names for the tasks. It will greatly simplify the project management and event filtering in the future.

  1. Click Finish. You can monitor the task status using task widget on project dashboard.
  2. Click the task name on the widget to see the details or use Show all link.

Caution: Don’t start the migration before the discovery task is finished. It might result in incorrect processing of migrated objects.

Setting Migration Defaults

To simplify the site migration, you can set a default site owner that will be used if the actual owner (user account) is not found in the target. See the details on user mapping below.

Caution: If both the actual owner account and the default owner are not found in the target, the migration task will fail.

  1. Click Configure Project on the project dashboard.
  2. In the Edit Project dialog, provide the user from the target tenant and click Save.

You can set a different default owner for a group of sites by overriding this setting in the migration task.

User Mapping Workflow

During the migration, On Demand Migration gets the accounts associated with the migrated (source) site and then looks up their pairs in the target tenant. Depending on the results, one of the following actions is performed:

  • If a matched target user is found, On Demand Migration sets it as an owner of the migrated site.
  • If a matched user is not found on target, On Demand Migration switches the site owner to the default account.
  • If the actual owner account has no match on the target and the default owner is missing, the migration task fails.

This table describes how ownership is handled by On Demand Migration depending on the SharePoint entity:

SharePoint Online Entity Matched owner found Matched owner missing Matched owner and default user missing
Top-level sites (site colections) Target account matched with source owner Default target user Migration Task fails
Subsites System account

System account


System account

System account

Folders Target account matched with source owner Default target user
Files Target account matched with source owner Default target user
List Items Target account matched with source owner Default target user
Related Documents