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 Webs

Webs or sub-sites that have not been migrated can be renamed, mapped to a different parent, or promoted to a site in the target tenant. When these objects are migrated, they will be renamed, relocated to the new parent or promoted to a site. The web is retained in the source tenant but set as Relocated (ie., not migratable)

The conditions for mapping a web to another web are as follows:

  • Web has not been previously migrated.
  • Web is not a root web.

If a web is promoted to a site, then:

  • Site must have a new name.
  • A new site and member objects are cloned form the web's parent site.
  • Web is cloned as the root web of the new site.
  • Children of the web are re-parented under the cloned web.
  • Migrate the new site to complete the migration of the promoted web

Example: Consider the promotion of a web (\sites\HR\Benefits) to a site (\sites\HR-Benefits). When the task completes, the SharePoint Contents list will display the following:

Type Name Source URL Target URL
Site HR \sites\HR  
Web HR \sites\HR  
Site HR-Benefits \sites\HR \sites\HR-Benefit
Web HR-Benefits \sites\HR \sites\HR-Benefit

Limitations

  • Links from the source web may not be updated on target. For example, links to the old parent.
  • For webs with unique SP Groups the groups may be duplicated.

To map a web

  1. Open the SharePoint contents tab and locate the list. You can use the list filter Type = Web to narrow down your search.
  2. Select a web that has not been migrated. You can select only one web at a time. Then click Map Web from the list detail pane.

  3. The New Web Mapping Task wizard starts. Specify the information in the steps described below:

  4. Map Settings
    1. Promote this web to a site collection - select this option to promote the web to a site. Webs with unsupported templates cannot have the template remapped and be promoted to site, so this setting will is displayed if the selected web has a supported template.
    2. Specify the new name and relative url
      • New Target Web Name - specify the new name of the target web if necessary, or retain the original name if you want to relocate the web.
      • New Target Url - Enter the new relative url of the web if you plan to relocate the web. This option is not available if the web is promoted to a site.
    3. Specify a supported target web template. This option is available if the selected site has an unsupported template.

      NOTE:

      To find webs with unsupported web templates, clear the filters in the search ribbon. Then set the following filters: Migration = Unsupported and Type = Web

      When you use a supported template, the original web features may not be provisioned. However, supported lists and list items can now be migrated to the target tenant.

      • New Target Web Template - choose Teams site (no Microsoft 365 group) from the dropdown.

    4. Click Next.
  5. 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 Web Name - new name of the target web
      • New Target Url - relative url of the site or web in the target tenant.
    2. Click Back to revise or review a previous step or click Finish to complete the task wizard and start the task as scheduled.
  6. You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
  7. When the task completes, the SharePoint Contents list is updated. Compare the Source Urlcolumn with the Target Url column for the selected web. The Provision state of the selected web is set to Mapped.

Mapping Lists

Lists or libraries that have not been migrated can be mapped to a different web on the target tenant or mapped to an existing list. When these objects are migrated, they can be relocated to the new SharePoint web or merged with a target list. This web can be in the same site or a different site.

  • The web in the target tenant must exist before the mapping otherwise mapping will fail.
  • Previously migrated lists cannot be mapped to a different web.
  • The source and target lists must have the same template type.
  • The list mapping will be used by a migration task that includes the list.
  • If lists are merged during migration, then
    • List objects merged
      • Content types
      • List columns
      • List Items (with permissions)
    • List objects not merged
      • List settings including Title and Description
      • List Permissions
      • Views
      • Alerts

To map a list to a different site or web

  1. Open the SharePoint Contents tab and locate the list. You can use the list filter Type = List to narrow down your search.
  2. Select a list that has not been migrated. You can select only one list at a time. Then click Map List from the list detail pane.

  3. The New List Mapping Task wizard starts. Specify the information in the steps described below:
  4. Map Settings

    1. Specify the new name and relative url
      • New Target Url - Enter the new name of the list or retain the original name. You can specify a different url in the target tenant to relocate the site if necessary.
    2. Choose a the mapping option
      • Migrate source list to target - select this option to migrate the contents of the source list to the specified target list
      • Merge source list contents with target list - select this option to merge the contents of the source list with the specified target list.
    3. Click Next.
  5. 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 Url - the relative url of the site or web in the target tenant.
      • Map option - 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.
  6. You can track the progress in the Tasks tab, monitor alerts and notifications in the Events tab and view the summary on the Dashboard.
  7. When the task completes, the SharePoint Contents list is updated. Compare the Source Urlcolumn with the Target Url column for the selected list. The Provision state of the selected list is set to Mapped.

Migrating Term Stores

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.

Term store migration for multi-geo site deployments are supported. Term groups that are not in the Central region must be migrated separately by migrating the regional Term Store.

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 Locations.

To migrate terms stores:

  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.
  6. Select the term stores to migrate. You can select multiple term stores.
  7. Click Migrate. The Migrate Term Store wizard starts. Each step is described below:
  8. 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.
  9. 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.
  10. Summary
    1. Verify the task specifications as described below:
      1. Name - name of the task. The default name is Migrate Term Store. 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.
  11. When the task completes, the Term Store list displays the term groups with Migration State = Migrated and Task Status = Completed. The Global Term Store tile in the Dashboard will also indicate the status of the task.

Migrating SharePoint Content

Use the SharePoint Contents tab to migrate SharePoint objects like sites, lists, web, members, retention policies and InfoPath forms. You can migrate an entire site or initiate a granular or incremental migration. You can navigate through SharePoint site objects and identify any site objects that failed to migrate.

Incremental migration

Incremental migration (or remigration) is typically used to synchronize and repair lists in the target tenant. When a list is remigrated, the contents of the list in the source and target tenants are compared. Missing items in the target are restored and items that are updated in the source since the previous migration will be incrementally migrated.

  • All child lists can be repaired and refreshed during migration of sites and webs.
  • Lists in the Migrated with Issues state will be repaired if the Refresh list items option is selected for the migration task.
  • Lists is in the Migrated state do not need to be repaired, and only an incremental migration will be done.

NOTE: The change token used by the migration service for incremental migration remains active for 60 days. It is recommended to perform an incremental migration every 50 days to make sure the change token remains active.

In this topic:

Migrating Record Center Retention Policies and InfoPath Forms

Migrating Record Center Retention Policies and InfoPath Forms requires a SharePoint token to be associated with the migration project to allow access to the Microsoft retention policy and InfoPath form APIs.

To associate a SharePoint token with the migration project using PowerShell:

  1. Download the PowerShell module and connect to ODM PowerShell to get the project id. See Appendix A: Working with PowerShell for more details.
  2. Get the project workloads (Accounts, Teams, SharePoint, Public Folders) 

    Get-OdmProjectWorkload -Project 'Elf813YBfQYAK6Q42Kun'

  3. Select the Id for the SharePoint project workload as the context 

    Select-OdmProjectWorkload -ProjectWorkloadId 'tH8u5nsB-aY5ES3q6NyZ'

  4. Get the SharePoint connection token 

    Set-OdmSpConnectionToken -ConnectionType target

  5. In the credentials window that opens, enter the On Demand credentials (typically the On Demand administrator)

    NOTE:

    • Token is stored in the SharePoint project
    • Token expires in 2-3 days. We recommend that you refresh the token after 2 days if you expect your migration to run for longer periods.
  6. Start the migration task. See Starting a SharePoint migration task for details.

To migrate tenant level settings:

  1. Log in to the SharePoint admin center of your target tenant.
  2. Go to More Features > InfoPath.

  3. Copy the information over from your source tenant.

Starting a SharePoint migration task

Any discovered SharePoint object where Provision state = Discovered, can be migrated including sites, lists (including individual lists) and webs (root and child webs). All children of the object selected for migration will be migrated.

Caution: Don’t start a migration before a discovery task completes, otherwise migrated objects could be incorrectly processed.

NOTES:

  • If the parent of the object selected for migration does not already exist on the target then the object will not be migrated.
  • Migration of a Group site will be skipped if the corresponding Group site does not already exist at the target Url.
  • Migration of a site or web initiates a rediscovery of any new child webs or lists, and a full migration of all child webs and lists.

To start a SharePoint migration 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 project Dashboard click Open in the SharePoint tile.
  5. Click the SharePoint Contents tab.
  6. Select the SharePoint objects to migrate. You can select multiple objects.
  7. Click Migrate. The New SharePoint Migration Task wizard starts. Each step is described below:
  8. Start
    1. Task Name - You can specify a custom name. The default name is Migrate SharePoint Contents.
    2. Use the settings from an existing migration template for this task - select this option if you have already saved a previous migration templates. if this is the first time you are migrating mailboxes, keep this option unchecked.
      • Select template - select a migration template that you previously created, from the dropdown list.
    3. Go to Summary step - select this option to preserve the settings and go directly to the last step of the wizard. If you do not select this option, but you have selected a template, you can step through the wizard and edit the settings in the template.
    4. Click Next.
  9. Migration Scope

    1. Choose a migration scope as described below:
      • Migrate all - select this option to migrate the selected objects including any descendants or content associated with these objects.
      • Migrate structure without list or library content - select this option to limit the scope of the migration to the full site structure like Site, Members (users and groups), Webs and Lists. List items will not be migrated.
      • Migrate selected objects without descendants or content - select this option to migrate only the selected objects. Any descendants or content associated with these objects will be ignored.
    2. Include site level term group as part of site migration - select this option to add site level metadata to the target Global Term Store. The Global Term Store must be migrated before you can use this option, otherwise an error will be logged as an event. For more information, see Migrating the Global Term Store.
    3. Click Next.
  10. Migration Options

    1. Configure the migration options as described below:
      • Default user account - Specify a default target user to use as the site collection owner if the existing owner cannot be matched with a target user.
      • Clear selected objects from the target - Select this option to delete the selected SharePoint objects that already exist on the target before being migrated. Clearing of Group site collections is not supported and will be skipped to keep the association with Microsoft 365 Groups and Teams.
      • Upgrade classic team sites to modern team sites - Select this option to upgrade classic team sites to modern team sites. If the classic team site does not exist on the target, create the site using the modern team site.
    2. Click Next.
  11. Permission Options

    1. Select how permissions are migrated. Direct permissions are always migrated.

      NOTE: To migrate permissions separately, see Migrating Permissions.

      • Migrate permissions - select this option so that unique permissions associated with sites, webs, list and list items are migrated. If you clear this option all other options in this step are deactivated and permission migration is prevented. When permissions are not migrated, the permissions for new migrations of sites, webs, lists and list items, that are not already on the target tenant, will be inherited from its parent. The permissions will not be changed for migrations of webs and lists that were already migrated to the target tenant. The permissions for previously migrated list items will be reset to inherit from its parent.
        • Do not migrate Sharing Links permissions - select this option to ignore Sharing Links permissions.
        • Migrate Sharing Links permissions as direct permissions. Migration is slower - select this option to include Sharing Links permissions. These permissions will be migrated as direct permissions. The conversion and migration of Sharing Links permissions takes more time to migrate.
    2. Click Next.
  12. List Options

    This step applies to specific lists selected for migration from the SharePoint Contents list view.

    1. Choose from the following options to determine how changes to list items that were previously migrated should be re-migrated:
      • Re-migrate all list items - all list items are migrated regardless of their previous migration status.
      • Migrate new, updated and failed list items - a subset of list items is migrated based on the selection of criteria described below:
        • Perform an incremental migration - an incremental migration is performed on new, updated and failed list items based on migration history recorded in the project repository.
        • Perform a full comparison migration - an incremental migration is performed but takes more time because each list item from the source and target data sets are compared to determine the list items for re-migration.
    2. Choose a conflict resolution option.

      NOTE:

      • Conflict resolution rules are applied only to lists that have been previously migrated.
      • Conflict resolution rules will not be applied if the Re-migrate all list items list option is selected in the previous section. All files in the target tenant will be overwritten if all files are migrated.
      • Conflict resolution rules will not be applied to Site Pages and Site Assets system libraries.
      • Overwrite target files - all migrated files in the target tenant will be overwritten. Migration is fastest with this option selected.
      • Skip if target list item is newer - ignore list items in the target tenant with the same or newer last modified date. If the item does not exist in the target tenant, a copy of the source item will be migrated.
      • Copy source file if target file is newer - preserve all list items in the target tenant and copy the source files if the target files have a newer last modified date. When you choose this option, you must choose from one of the following file suffix options: _Copy, _Source, _Older, _Backup, and _1.
    3. Migrate list and library comments - select this option to include list and library comments in the migration task. A large number of list and library comments increase task processing time.
    4. Auto re-run list item migrations to retry missing items - select this option to automatically re-run the list item migration during list migrations to retry and repair missing items.
    5. Click Next.
  13. : Version Options
    1. Specify the versions of the SharePoint files to migrate. These options are relevant only if the Migrate all option is selected in the Migration Scope step.

      NOTE: When you select a conflict resolution option and a version option, you should expect the following behavior for the following options in List Optionss step:

      Overwrite target files - the file is replaced with the file and version history from the source based on the version settings.

      Skip if target list item is the same version or newer - the target file is not changed, but new items migrated will follow versions settings.

      Create a copy if target list item is the same version or newer - the copy is migrated using the version settings.

      Each site has its own version history of its files and each change to a file is saved with a new version. Select from the following migration options to determine how SharePoint file versions should be migrated:

      • Latest version only - This is the default selection. The most recent version of the file will be migrated. All other versions will be ignored.
      • More versions - Additional versions of a file will be migrated based on the options described below. Large version sets take a significantly long time to migrate.
        • Number of versions - The maximum number of version to migrate. The available choices are: 2, 5, 10, 30, 60, 90 and 365. When you specify the number of versions, additional options can be selected.
          • Latest version and preceding versions - The version count includes the latest version and the preceding versions in chronological order restricted to the Size Limit of the latest version. For example, if you choose to migrate 5 versions, then the most recent version and 4 preceding versions will be migrated as long as the most recent version does not exceed the selected size limit specified.
          • Latest version and daily latest from preceding days - The version count includes the latest version and the latest version from each preceding day restricted to the Size Limit of the latest version. For example, if there are many versions of a site and you choose to migrate 5 versions, then the most recent version and the latest version from each of the 4 preceding days will be migrated as long as the most recent version does not exceed the selected size limit specified.
          • Size limit - This setting is available if the Latest version and preceding versions or the Latest version and daily latest from preceding days option is selected. By default, the size limit is 80 MB. You can configure the size limitation by selecting from one of the possible values in the dropdown list. If the size of the latest file version exceeds the selected size limit, the latest version will be migrated and previous versions will be ignored. If the size of the latest file version does not exceed the selected size limit, then the file and its versions will be migrated based on your selection between Latest version and preceding versions or Latest version and daily latest from preceding days.
      • All Versions - The latest version of the file will be migrated, and all previous versions of the file will be migrated if the latest version does not exceed a specified size limit. This option requires significantly more time to migrate all the versions.
        • Size limit - This setting is available if the All Versions option is selected. By default, the size limit is 80 MB. You can configure the size limitation by selecting from one of the possible values in the dropdown list. If the size of the latest file version exceeds the selected size limit, the latest version will be migrated and previous versions will be ignored. If the size of the latest site version does not exceed the selected size limit, then the file and its versions will be migrated.
    2. Click Next.
  14. Notification
    1. Send notification email once the task is completed - select this option to send a notification email when a task completes.
      • Only in a case of failure - Select this option to send the email if the 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.
  15. 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.
      • 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.
    2. Click Next.
  16. Reporting

    Select the check box Generate detailed report of migration errors to generate a migration error report when you run the New SharePoint Migration Task wizard.

    You can download the report from the Reports tab of the SharePoint workspace by clicking the Download link in the Error Log column. If there are no migration errors, a download link is not available. Error reports are retained for 30 days. After 30 days the download link is replaced with the label Expired and you can no longer download the report. For more information about error reports, see Reports.

  17. Summary
    1. Save task settings as a migration template - select this option to save the settings in this wizard as a reusable migration template.
      • Migration Template Name - specify a name for the template. If you have changed the settings of a preselected template, specify the same template name to apply the changes to the template when you complete the wizard. All saved templates are displayed in the Templates tab.
    2. This step lists the following configured options for this task.
      • Name - Name of the task. You can specify a custom name. The default name is Migrate SharePoint Contents.
      • SharePoint objects selected - number of SharePoint objects selected for migration.
      • Migration Scope - selected migration scope.
      • Include site level term groups from Term store - whether or not the site level term group from the Term store should be included in the migration.
      • Default target user - UPN of the default target user if the source user cannot be matched to a target user.
      • Clear selected objects from target - whether or not the target site collection are deleted if it exists is the target tenant.
      • Upgrade classic team sites - whether or not classic team sites are migrated to modern team sites.
      • Migrate permissions - whether permissions are migrated or migrated objects will inherit permissions from their parent.
      • Migrate permissions only - whether or not permissions are migrated for previously migrated webs and lists.
      • Migrate Sharing Links permissions - how Sharing Links permissions are migrated.
      • List migration - choice between migration of all list items or migration of incremental changes with a refresh.
      • Conflict Resolution migration action - how version conflicts are resolved. Indicates the suffix if a copy of migrated list items are created.
      • Migrate list and library comments - whether or not list and library comments should be migrated.
      • Migrate list item and document versions - version option selected.
      • Scheduled start - expected start time of the task.
      • Priority - the priority of this task.
      • Generate detailed report of migration errors - option to collect and retain data for report generation.
    3. Click Back to change configurations if necessary or click Finish to save and start the task as scheduled.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating