Discovering Sites
The On Demand Migration for SharePoint service must have a reference list of all the sites that can be migrated to the target tenant.
in this topic:
|
|
NOTE: Before you begin, ensure you have migrated all the accounts to the target tenant. At the minimum, ensure that all SharePoint users are migrated. For more information see Account Migration. |
Discovering all sites
This is the simplest approach which uses the Discovery Task to inspect the source tenant and discover all the site collections.
To start a site discovery task:
- Sign in to Quest On Demand and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- From the SharePoint tile on the project dashboard click Open. The SharePoint Migration Workspace opens.
- Go to the SharePoint Contents tab. Then click Discovery > Discover All Sites. The New Discover All Sites Task wizard starts. Each step is described below:
- Notification
- Task Name - name of the task. You can specify a custom name. The default name is Discover All Sites.
- Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
- Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
- Recipients - enter the email address of the recipients of this email. This field is available after you select the notification option and is pre-filled with your email address. Specify multiple recipient email addresses separated by semicolons.
- Click Next.
- Schedule
- Choose from one of three options to schedule the task. The scheduler will be activated after you complete the task wizard.
- Run now - task runs immediately.
- Run later - task must be started manually.
- Schedule - task starts at a future date and time entered in the corresponding calendar field.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Task Name - name of the task. You can specify a custom name. The default name is Discover All Sites.
- Source tenant - name of the tenant where the site discovery occurs.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
- After the task is complete, the SharePoint Contents list is updated. The Migration state of each site is set to Discovered.
Discovering sites from a file
When you want to migrate a few sites, you can run the discovery process by using a CSV file. The file contains the site URLs and restricts the discovery of sites to the list of URLs provided in the CSV file. This is a two-step process:
Step 1: Prepare the CSV file
|
|
NOTE: CSV file names with non-ASCII characters are not supported. Using a CSV file provides the following additional benefits:
- The CSV file could contain more columns. The extra columns are ignored. If there are multiple columns with the headers URL, URI or SourceURL, all the columns will be processed.
- The URL could be either a relative URL or a URL with a fully qualified domain name. For the root site (e.g. https://starzcorp.sharepoint.com) use "/" as the relative URL.
- The specified URL can be in upper, lower or mixed case. Case is ignored during discovery.
|
You can prepare the CSV file in two ways:
- Download the CSV file from the SharePoint Admin Center
- Sign in to the SharePoint Admin Center of the source tenant.
- From the navigation pane, click Active sites.
- From the Active sites page menu, click Export to download the CSV file.
- Edit the CSV file to list only the sites in the URL column that should be discovered. You can either delete the other columns to maintain a cleaner list.
- Create a new CSV file
- Enter the column header SourceURL. It is case insensitive. Enter the URLs in the subsequent rows manually.
|

|
NOTE:
- You can download a CSV template when you start the New Discover Sites From File Task wizard and click Download Example File from the Discovery Options step.
- CSV file names with non-ASCII characters are not supported.
|

- Save the CSV file. You may rename the file if needed.
Step 2: Start the discovery task
- Sign in to Quest On Demand and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- Click the SharePoint tile, or click Open from the SharePoint tile to open the SharePoint Migration Workspace.
- From the menu click Discovery > Discover Sites from File. The New Discover Sites From File Task wizard starts. Each step is described below:

- Discovery Options
- Click Browse and locate the CSV file that contains the site collections to be discovered.
- Click Open in the File Explorer window to load the file into the wizard.
- Click Next.
- Notification
- Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
- Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
- Recipients - enter the email address of the recipients of this email. This field is available after you select the notification option and is pre-filled with your email address. Specify multiple recipient email addresses separated by semicolons.
- Click Next.
- Schedule
- Choose from one of three options to schedule the task. The scheduler will be activated after you complete the task wizard.
- Run now - task runs immediately.
- Run later - task must be started manually.
- Schedule - task starts at a future date and time entered in the corresponding calendar field.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Task Name - name of the task. You can specify a custom name. The default name is Discover Sites from File.
- Source tenant - name of the tenant where the sites are discovered.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
- After the task is complete, the SharePoint Contents list is updated. The Migration state of each site is set to Discovered.
Reviewing the premigration report
- Select the Tasks tab in the SharePoint workspace.
- Select the Discover Sites from File task.
- From the task detail pane, click Download Premigration Report.
- Download and save the ZIP file to a suitable folder, and extract the report. The report covers all the sites discovered.
|
|
NOTE: Premigration reports are also available from the Discover SharePoint Contents detail pane. This report covers all the site contents for the specific sites selected for this task. See Reports for more download options. |
Discovering Term Store
When you start a task to discover the term store, the task discovers all the term stores across geo locations in your organization. If your organization has a common location, only one term store will be discovered for the default geo location of your organization. If you have multi-geo enabled, you will see one term store per active region.
|
|
NOTE: Discovering and migration of term stores is optional. If you don't use managed meta data from the term store in your SharePoint sites then you don't need to discover and migrate the term stores. |
To discover term stores:
- Sign in to Quest On Demand and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- From the project Dashboard click Open in the SharePoint tile.
- Click the Term Store tab.
- Click Discover. The Discover Term Store wizard starts. Each step is described below:
- Notification
- Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
- Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
- Recipients - enter the email address of the recipients of this email. This field is available after you select the notification option and is pre-filled with your email address. Specify multiple recipient email addresses separated by semicolons.
- Click Next.
- Schedule
- Choose from one of three options to schedule the task. The scheduler will be activated after you complete the task wizard.
- Run now - task runs immediately.
- Run later - task must be started manually.
- Schedule - task starts at a future date and time entered in the corresponding calendar field.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Name - name of the task. You can specify a custom name. The default name is Discover Term Store.
- Source tenant - name of the tenant where the site discovery occurs.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
- After the task is complete, the Term Store list displays the term groups with Migration State = Discovered and Task Status = New. The Global Term Store tile in the Dashboard will also indicate the status of the task.
|
|
NOTE: If you want to migrate SharePoint Term Stores to a geo located target tenant, you must map the discovered source tenant Term Stores to active geo locations in the target tenant. For more information see Mapping Geo Located Term Stores. |
Discovering Site Contents
Discovering the site structure and content provides a better understanding of the scope of the migration. The SharePoint contents list displays the following SharePoint object types: Site (site collection), Web (root site), Lists, Webs (sub sites, child sites). The display will include the number of lists and the number of items in each list.
In this topic:
Starting a Discover SharePoint Contents Task
- Sign in to Quest On Demand and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- Click the SharePoint tile, or click Open from the SharePoint tile to open the SharePoint migration workspace.
- Click the SharePoint Contents tab to open the SharePoint Contents list view.
- Choose one or more sites by selecting the respective check box for the site. You can select the check box in the column header to select all sites.
- Click Discovery > Discover SharePoint Contents from the Actions ribbon. The New Discover SharePoint Contents Task wizard starts. Each step is described below:
- Options
- Task Name - name of the task. You can specify a custom name. The default name is Discover SharePoint Contents.
- Collect forms and workflow statistics - select this option to count the number of InfoPath forms and workflows associated with the selected sites.
- Click Next.
- Notification
- Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
- Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
- Recipients - enter the email address of the recipients of this email. This field is available after you select the notification option and is pre-filled with your email address. Specify multiple recipient email addresses separated by semicolons.
- Click Next.
- Schedule
- Choose from one of three options to schedule the task. The scheduler will be activated after you complete the task wizard.
- Run now - task runs immediately.
- Run later - task must be started manually.
- Schedule - task starts at a future date and time entered in the corresponding calendar field.
- Priority - select a priority from the dropdown for the objects scheduled for migration with this task . Values are: Highest, High, Medium, Low and Lowest. The default priority is Medium. If the system is busy, the objects are queued (Migration state = Queued). When the system accepts new migration work, objects are taken from the queue based on the assigned priority and age in the queue.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Task Name - name of the task. You can specify a custom name. The default name is Discover SharePoint Contents.
- Source tenant - name of the tenant where the statistics will be collected.
- Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
Viewing the SharePoint contents
- Sign in to Quest On Demand and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- Click the SharePoint tile, or click Open from the SharePoint tile to open the SharePoint migration workspace.
- Click the SharePoint Contents tab to open the SharePoint Contents list page.
- To view the contents for a specific site:
- Clear any filters in the Filter panel
- Set the Type filter to Site from the dropdown list. The list of sites and site collections are displayed.
- Select a site by clicking the corresponding check box. The site detail panel opens.
- Click Show Content. The site contents are displayed in the list.

- To view the contents for a specific content type:
- Clear any filters in the Filter panel
- Set the Type filter to a content type from the dropdown list. The list of content types are displayed.
Reviewing the premigration report
- Select the Tasks tab in the SharePoint workspace.
- Select the Discover SharePoint Contents Task that you want to review.
- From the task detail pane, click Download Premigration Report.

- Download and save the ZIP file to a suitable folder, and extract the report.
|
|
NOTE: This premigration report covers all the site contents for the specific sites selected for this task. Premigration reports for all sites (excluding site contents) are also available from the following tasks:
- Discover All Sites
- Discover Sites from File
|
Comparing Site Contents
The Compare SharePoint Content task compares items in the list between source and target tenants.
- For tasks that include site and web all the child list and libraries will be compared.
- Comparison is only supported for list and libraries previously migrated by the ODMSP service.
- Comparison is done based on the item's UniqueID which is maintained when the ODMSP service migrates an item to the target. List item, files and folders are compared.
In this topic:
Starting a Compare SharePoint Contents Task
- Sign in to Quest On Demand and choose an organization if you have set up multiple organizations.
- From the navigation pane, click Migrate > Projects to open the My Projects list.
- Create a new project or open an existing project.
- Click the SharePoint tile, or click Open from the SharePoint tile to open the SharePoint migration workspace.
- Click the SharePoint Contents tab to open the SharePoint Contents list view.
- Choose one or more sites, webs or lists that have been previously migrated, by selecting the respective check boxes.
- Click More > Compare from the Actions ribbon. The New SharePoint Compare Task wizard starts. Each step is described below:
- Notification
- Task Name - name of the task. You can specify a custom name. The default name is Compare SharePoint Content.
- Send notification email once the task is completed - select this option to send a notification email when a discovery task completes.
- Only in a case of failure - select this option to send the email if the discovery task fails to complete successfully.
- Recipients - enter the email address of the recipients of this email. This field is available after you select the notification option and is pre-filled with your email address. Specify multiple recipient email addresses separated by semicolons.
- Click Next.
- Schedule
- Choose from one of three options to schedule the task. The scheduler will be activated after you complete the task wizard.
- Run now - task runs immediately.
- Run later - task must be started manually.
- Schedule - task starts at a future date and time entered in the corresponding calendar field.
- Priority - select a priority from the dropdown for the objects scheduled for migration with this task . Values are: Highest, High, Medium, Low and Lowest. The default priority is Medium. If the system is busy, the objects are queued (Migration state = Queued). When the system accepts new migration work, objects are taken from the queue based on the assigned priority and age in the queue.
- Click Next.
- Summary
- Verify the task specifications as described below:
- Name - name of the task. You can specify a custom name. The default name is Compare SharePoint Content.
- Source tenant - name of the tenant whose SharePoint objects are compared.
- SharePoint objects selected - number of SharePoint objects selected for comparison.
- Priority - the priority of this task.
- Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
Reviewing the comparison report
One report is generated for each list in the site, web or lists selected. All items are included in the CSV report for lists that contain up to 100,000 items. For lists above 100,000, all matched items are not included in the CSV report, but only differences are reported.
- Select the Tasks tab in the SharePoint workspace.
- Select the Compare SharePoint Content task (or whatever custom name you have assigned).
- From the task detail pane, click Reports. The Reports list opens with a predefined filter on the task that you selected.

- From the Reports list, select a list and click Download from the Download Log column to save the CSV file to your default download folder.
- The Comparison Status column has the following values:
- Matched - items with the same ID are on source and target with same modified date.
- Only on source - item is only on source.
- Only on target - item is only on target.
- Newer on source - version of item with the same ID is newer on the source than the target.
- Newer on target - version of item with the same ID is newer on the target than the source.
- Different name - Items with the same ID but different names are on the source and target i.e. file was renamed.
- You can check the Modified date to determine which is newer.
- Different location - Item with same ID but in a different location or path are on the source and target i.e. file was moved within the list.
- Modified date remains the same as the move operation in SharePoint does not change the modified date.
- If a file was renamed and moved it is indicated as Different Location.