Chat now with support
Chat with Support

On Demand Migration Current - User Guide

About On Demand Migration Working with On Demand Migration Account Migration Mailbox Migration OneDrive Migration Microsoft Teams Migration Microsoft 365 Groups Migration SharePoint Migration Public Folders Migration Power BI Migration Troubleshooting Finalizing the Migration Appendix A: Using PowerShell Appendix B: How Queuing Works

Mapping Geo Located Term Stores

If you want to migrate SharePoint Term Stores to a geo located target tenant, you must map the discovered source term stores to active geo locations in the target tenant using a CSV file. This is a two-step process:

Prepare the CSV file

NOTE:

  • You need to map only the URLs that will change in the target Tenant.
  • You can download a CSV template when you start the New Map Geo Locations Term Store Task wizard and click Download Example File from the Mapping File step.
  • CSV file names with non-ASCII characters are not supported.

To prepare a CSV file with geo mapped SharePoint sites, use the CSV format described below:

  • Source Location - column header for the geo location of the source term store. The geo location could be blank if your source tenant is not geo enabled.
  • Target location - column header for the geo location of the term store in the target tenant. The geo location could be blank if you choose to use the Default target geo location in the SharePoint project settings.

Start the Map Geo Locations From Term Store Task

The New Map Geo Locations Term Store Task wizard maps the geo locations of migrated SharePoint Term Stores based on the mappings in the CSV file described in the previous section.

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. From the project Dashboard click Open in the SharePoint tile.
  5. Click the Term Store tab. Then click More > Map Geo Locations. The New Map Geo Locations Term Store Task wizard starts. Each step is described below:

  6. Mapping File
    1. Click Browse and select the CSV file with the geo location mappings that you prepared.
    2. Click Open in the File Explorer window to load the file into the wizard
    3. Click Next.
  7. Schedule
    1. Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
      • Run now - task runs immediately.
      • Run later - task must be started manually.
      • Schedule - task will be started at a future date and time entered in the corresponding calendar field.
    2. Click Next.
  8. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Map Geo Locations From Term Store Task. You can specify a custom name.
      2. Source tenant - name of the tenant where the statistics will be collected.
      3. Target tenant - name of the target tenant in this project.
      4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.

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 the 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 the Discover Site Task:

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. From the SharePoint tile on the project dashboard click Open. The SharePoint Migration Workspace opens.
  5. 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:
  6. Notification
    1. 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.
    2. Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
    3. Click Next.
  7. Schedule
    1. 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 will be started at a future date and time entered in the corresponding calendar field.
    2. Click Next.
  8. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Discover All Sites Task. You can specify a custom name.
      2. Source tenant - name of the tenant where the site discovery occurs.
      3. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
  9. When the task completes, the SharePoint Contents list is updated. The Provision 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
    1. Log in to the SharePoint Admin Center of the source tenant.
    2. From the navigation pane, click Active sites.
    3. From the Active sites page menu, click Export to download the CSV file.
    4. 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
    1. 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.

    2. Save the CSV file. You may rename the file if needed.

Step 2: Start the discovery task

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click theSharePointtile, or click Open from the SharePoint tile to open the SharePoint Migration Workspace.
  5. From the menu click Discovery > Discover Sites from File. The New Discover Sites From File Task wizard starts. Each step is described below:

  6. Discovery Options
    1. Click Browse and locate the CSV file that contains the site collections to be discovered.
    2. Click Open in the File Explorer window to load the file into the wizard.
    3. Click Next.
  7. Notification
    1. 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.
    2. Recipients - enter the email address of the recipients of this email. You can specify multiple recipient email addresses separated by semicolon.
    3. Click Next.
  8. Schedule
    1. 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 will be started at a future date and time entered in the corresponding calendar field.
    2. Click Next.
  9. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Discover Sites from File Task. You can specify a custom name.
      2. Source tenant - name of the tenant where the statistics will be collected.
      3. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
  10. When the task completes, the SharePoint Contents list is updated. The Provision state of each site is set to Discovered.

Reviewing the premigration report

  1. Select the Tasks tab in the SharePoint workspace.
  2. Select the Discover Sites from File Task that you want to review.
  3. From the task details pane, click Download Premigration Report.
  4. 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 Task detail pane. This report covers all the site contents for the specific sites selected for this task.

 

Mapping Geo Located Sites

NOTE:

This feature is available if the target tenant is geo-enabled.

We recommend that you run the Map Geo Location task before you run the Mapping from File task. The Mapping from File task sets the geo locations using the default settings, and once the target location is set it can't be reset by the Map Geo Location task.

Workaround: Delete site from the SharePoint Contents list and rerun the Discover Site Collections task.

If you want to migrate SharePoint sites to a geo located target tenant, you must map the discovered source tenant sites to active geo locations in the target tenant using a CSV file. This is a two-step process:

Step 1: Prepare the CSV file

NOTE:

  • You need to map only the URLs that will change in the target Tenant.
  • You can download a CSV template when you start the New Map Geo Location Task wizard and click Download Example File from the Mapping File step.
  • CSV file names with non-ASCII characters are not supported.

To prepare a CSV file with geo mapped SharePoint sites, use the CSV format described below:

  • Source Url - column header for the urls of the site in the source tenant
  • Source Location - column header for the geo location of the source site. The geo location could be blank if your source tenant is not geo enabled.
  • Target location - column header for the geo location of the site in the target tenant. The geo location could be blank if you choose to use the Default target geo location in the SharePoint project settings.

Step 2: Start the Map Geo Location Task

The New Map Geo Location Task wizard maps the geo locations of migrated SharePoint sites based on the mappings in the CSV file described in the previous section.

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. From the project Dashboard click Open in the SharePoint tile.
  5. Click the SharePoint Contents tab. Then click More > Map Geo Location from File. The New Map Geo Locations Task wizard starts. Each step is described below:

  6. Mapping File
    1. Click Browse and select the CSV file with the geo location mappings that you prepared.
    2. Click Open in the File Explorer window to load the file into the wizard
    3. Click Next.
  7. Schedule
    1. Choose from one of three options to schedule the task. The scheduler will be activated only after you complete the task wizard.
      • Run now - task runs immediately.
      • Run later - task must be started manually.
      • Schedule - task will be started at a future date and time entered in the corresponding calendar field.
    2. Click Next.
  8. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Map Geo Location. You can specify a custom name.
      2. Source tenant - name of the tenant where the statistics will be collected.
      3. Target tenant - name of the target tenant in this project.
      4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.

 

Mapping Sites

By default, the OnDemand Migration for SharePoint service will migrate a site using the same relative url and name as the source site. This step is particularly helpful when the source and target sites have different names or are located at different places. You can also change the template of sites with unsupported templates. There are two ways to map sites:

A site cannot be mapped if it was previously migrated in the same project. See the Considerations topic for details about migration behavior if the target site or sub-site that is mapped, already exists before the migration is started.

Mapping a specific site from the user interface

To change the name of a specific migrated site, relocate the site with a different Url or change an unsupported template during migration, follow the steps described below.

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click theSharePointtile, or click Open from the SharePoint tile to open the SharePoint Migration Workspace.
  5. Go to the SharePoint Contents tab.
  6. Select a specific site and then click Map Site from the site detail pane.

  7. The New Site Mapping Task wizard starts. Each step is described below:
  8. Map Settings

    1. Specify the new target site name and url :
      • New Target Site Name - specify the new name of the target site (root website) if necessary, or retain the original name.
      • New Target Url - specify the relative url in the target tenant or retain the original value. You can specify a different relative url in the target tenant to relocate the site if necessary.
    2. Specify a supported target site template. This option is available if the selected site has an unsupported template.

      NOTE:

      To find sites with unsupported site templates, clear the filters in the search ribbon. Then set the following filters: Migration = Unsupported and Type = Sites

      Template mapping is only available for unsupported templates. When you use a supported template, the original site features may not be provisioned. However, supported lists and list items can now be migrated to the target tenant.

      Limitation: Sites with the "TeamsChanne#0" or "TeamsChanne#1" template cannot be mapped to a different template. These TeamsChannel based sites are provisioned with the ODM Teams provisioning task.

      • New Target Site Template - choose a supported template. The options are: Communication and Teams site (no Microsoft 365 group).

    3. Promote child webs to sites - select this option to promote all first level child webs in this site to a new site. Promoted site name and url will be based on the current name of the promoted child web. This option is available for supported sites only. Sites with unsupported templates cannot be promoted.
    4. Click Next.
  9. Summary
    1. Verify the task specifications as described below:
      • Name - name of the task. The default name is Map Single SharePoint Object Task. You can specify a custom name.
      • New Target Site Name - new name of the target site (root website)
      • New Target Url - the relative url in the target tenant.
      • New Target Site Template - option to match sub-sites and other descendant structures.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
  10. You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
  11. When the task completes, the SharePoint Contents list is updated. Compare the Source Urlcolumn with the Target Url column for the selected site. The Provision state of the selected site is set to Mapped.

Mapping one or more sites with a CSV file

To change the name of a migrated site or relocate the site with a different Url, use a CSV file to set up a custom map. URLs in a mapping file are case sensitive and must be relative URLs. This is a two-step process:

NOTE: If your sites are geo-enabled, we recommend that you run the Map Geo Location task before you run the Mapping from File task. The Mapping from File task sets the geo locations using the default settings, and once the target location is set it can't be reset by the Map Geo Location task.

Workaround: Delete site from the SharePoint Contents list and rerun the Discover Site Collections task.

Prepare the CSV file

There are three ways to prepare a CSV site mapping file.

NOTE: Sites cannot be merged or reorganized with a mapping file. Site templates cannot be changed with a CSV file.

  1. Download the CSV file from the SharePoint Admin Center
    1. Log in to the SharePoint Admin Center of the source tenant.
    2. From the navigation pane, click Active sites.
    3. From the Active sites page menu, click Export to download the CSV file.
    4. In the CSV file, delete all columns before the URL column. Rename the URL column header to either SourceURL. This must be the first column.
    5. In the SourceURL column keep only the sites that you want to map. Ensure that only relative URLs are used.
    6. Insert a blank column as the second column and specify the header as either TargetURL This must be the second column.
    7. Specify the corresponding target URLs. Ensure that only relative URLs are used.
  2. Download the CSV file from the SharePoint Contents page
    1. 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.
    2. Click Export from the Actions ribbon.
    3. Extract the CSV file from the downloaded ZIP file.
    4. In the CSV file, delete all columns before the SourceURL column. This must be the first column.
    5. Insert a blank column as the second column and specify the header as either TargetURL. This must be the second column.
    6. Specify the corresponding target URLs. Ensure that only relative URLs are used.
  3. Create a new CSV file and specify the column header in the first row and then enter the URLs in the subsequent rows manually. Since URLs in a mapping file are case sensitive, this method must be used with caution.

    NOTE:

    • You need to map only the URLs that will change in the target Tenant.
    • You can download a CSV template when you start the New Mapping from File Task wizard and click Download Example File from the Mapping File step.
    • CSV file names with non-ASCII characters are not supported.
    1. In the first column, specify the header as either SourceURL.
    2. In the second column, specify the header as either TargetURL.
    3. Enter the source and target URLs manually in the subsequent rows . Ensure that only relative URLs are used.
    4. Save the CSV file. You may rename the file if needed.

Example 1 - The Target URL is used to rename a site from the source tenant.

  • The URL /sites/StarzBrand has been renamed to /sites/StarzCorporate.
  • The URL /sites/StarzAccounting has been renamed to /sites/StarzFinance.
  • The URL /sites/Starzmarketing has been renamed to /sites/StarzMarketing.
  • The URL /sites/Starzteam has been renamed to /sites/StarzTeam.

Example 2 - The target URL is used to relocate the root site.

The root URL is relocated to a managed site in the target tenant called /sites/oldroot.

Start the Mapping from File Task

  1. Log in to Quest On Demand and choose an organization if you have set up multiple organizations.
  2. From the navigation pane, click Migration to open the My Projects list.
  3. Create a new project or open an existing project.
  4. Click theSharePointtile, or click Open from the SharePoint tile to open the SharePoint Migration Workspace.
  5. Go to the SharePoint Contents tab.
  6. From the Actions toolbar, click More > Map from File. The New Mapping from File Task wizard starts. Each step is described below:

  7. Mapping File
    1. Click Browse and locate the CSV mapping file.
    2. Click Open in the File Explorer window to load the file into the wizard
    3. Click Next.
  8. Schedule
    1. 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 will be started at a future date and time entered in the corresponding calendar field.
    2. Click Next.
  9. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Mapping from File Task. You can specify a custom name.
      2. Source tenant - name of the tenant where the source URLs exist.
      3. Target tenant - name of the tenant where the target URLs may or may not exist.
      4. Scheduled start - date and time when the task will start. Now indicates that the task will start immediately.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
  10. You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
  11. When the task completes, the SharePoint Contents list is updated. Compare the Source Urlcolumn with the Target Url column for the selected sites. The Provision state of each matched site is set to Mapped.

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating