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 Troubleshooting Finalizing the Migration Appendix A: Using PowerShell

Upgrading Throttling Policies

Exchange Web Services (EWS) are throttled by Microsoft whenever large quantities of data flows through the EWS platform. The On Demand Migration service throughput can be improved by upgrading the following throttling policy parameter setting to Unlimited:

  • EwsMaxBurst - Defines the amount of time that an EWS user can consume an elevated amount of resources before being throttled. This is measured in milliseconds. This value is set separately for each component.
  • EwsRechargeRate - Defines the rate at which an EWS user's budget is recharged (budget grows by) during the budget time.
  • EwsCutoffBalance - Defines the resource consumption limits for EWS user before that user is completely blocked from performing operations on a specific component.

Tenant administrators can upgrade the throttling policies by making a service request with Microsoft. See article for more information.

Desktop Update Agent

To complete a migration project, a lightweight user desktop application called Desktop Update Agent (DUA) must be configured and deployed by administrators and run on users workstations. DUA provides enhanced support, helps ensure the success of cross-tenant migration projects, makes agent delivery easier, and status reporting more informative.

DUA features:

  • Ability to manage user’s application reconfigurations activities from a single view within On Demand Migration.
  • Support for OneDrive for Business and Microsoft Teams.
  • Support for Microsoft 365 application license reset.
  • Support for various client authentication mechanisms.

For more information about downloading, administration and use of DUA, see the Quest On Demand Migration Update Agent Guide.

Test and Pilot Migrations

Any full scale migration should be preceded by test and pilot migrations, to confirm that your migration processes and procedures will accommodate the organization requirements.

  • A test migration uses real users and real data in a segregated test environment, or dummy users and dummy data in your live production environment.
  • A pilot migration uses a small portion of real users and real data in the live production environment.

In either case - a test or pilot migration - the data to be migrated should be a representative sample of the production data, and the test or pilot migration should be run with the Quest applications set for the same configuration and process options that you intend to use for the production migration. it is recommended to select test or pilot users whose usage and data types make them representative of the total user population. Then create and run matching / migration tasks for those accounts, including all range of tasks you are planning to perform. When the tasks are completed, review errors and warnings, if any. See Event Management section for more information.

Quest recommends that you use both test and pilot migrations:

Perform one or more test migrations in a separate test environment, migrating test copies of real users and their real data. The separate test environment ensures that no test process will affect the data or configurations of your production environment. If a test exposes any problems under migration, you can make amendments and then repeat the test by simply dumping the test environment and recreating it from scratch.

When you are confident that your test migrations have sufficiently refined your planned migration, perform a pilot migration for 20 or 30 users to verify if your planned migration is satisfactory for your "real world."

Project Management

A migration project contains the full set of migration features and provides a summary of all the migration activities in the project dashboard. You can work with a single migration project for small migrations or you can set up multiple migration projects to split larger migration plans into manageable projects.


In this topic:

Creating a new migration project

  1. Sign in to Quest On Demand.
  2. From the navigation pane, click Migration to open the Migration projects view.

  3. To use the new project management user interface, turn on the Try the new project wizard toggle.
  4. Click Create Project.


    If you have already created one or more projects, click Create Project as shown below.

  5. The New Project wizard starts.
  6. Step 1: Project Detail

    Enter the information in the fields as described below:

    1. Title - Specify a meaningful name for the project. Maximum number of characters is 128.
    2. Description - Enter a description about the project. Maximum number of characters is 200.
    3. Source Tenant - Select a source tenant from the dropdown list.
    4. Target Tenant - Select a target tenant from the dropdown list.
    5. Click Save and Continue.

  7. Step 2: Assets

    Select one or more assets from the set of information assets that you want to migrate. The Account asset is mandatory because all other assets are directly or indirectly linked to active directory accounts in your source and target tenants.

    Each asset is treated as an application for migration purposes and automatically assigned a service principal.

  8. Step 3: Consents

    Most Microsoft 365 objects can be migrated when the service principals for each asset have been granted the consent. See Consents and permissions for more information.

    To grant consent the service principals:

    1. Click Grant Consent to grant the consents to the service principal if the tenant consents were not granted when you added the tenants.


      Click Regrant Consent to refresh the consents granted to the service principals. It is recommended that you regrant consent to ensure that the consent to the service principals are refreshed.

    2. Migration of some Microsoft 365 objects require a user principal with the Global Administrator or other specific roles and you must provide additional authorization. Typically, the tenant administrator credentials are provided. You can provide the credentials for authorization in an Features step.

      Select Yes. Proceed to activate the Features step. Select No. Skip to ignore the Features step.

    3. Click Save and Continue.

  9. Step 4: Features

    NOTE: This step is available if you select Yes. Proceed in the previous step.

    To grant additional authorization with a source and target user principal:

    1. Enter the email address of the target user accounts.
    2. Enter the password of the target user accounts.
    3. Click Save and Continue, or click Skip this page to avoid entering and verifying user principal accounts.

  10. Step 5: Overview
    1. Verify the information you have provided for each step. Click Edit to return to the step and revise the information as needed.
    2. Select Open Project to open the project dashboard.
    3. Click Finish to activate the project.
    4. Click Open Project to open the project workspace.

Viewing migration projects

  1. Sign in to Quest On Demand.
  2. From the navigation pane, click Migration to open the Migration projects view.
  3. You can view the projects in two formats:
    1. Tile view
      • This view presents each project as a tile. Click from the view selector in the actions menu to select this view.
      • It is the default view and contains links to the migration workspaces from the set of icons in the tile.
      • You can sort the tiles by Date Created or Alphabetical from the sort criteria dropdown in the actions menu.
    2. List View
      • This view displays the projects as a list. Click from the view selector in the actions menu to select this view.
      • This view is useful when you have a large number of projects. Click on a column header to sort the list by its column values.

Renaming a migration project

  1. Sign in to Quest On Demand.
  2. From the navigation pane, click Migration to open the Migration projects view.
  3. From the top right-hand corner of the project panel, click the More Actions icon (3 dots). Then click Edit.
  4. Revise the project name or description as needed.
  5. Click Save to save the changes and close the dialog.

Deleting a migration project

  1. Sign in to Quest On Demand.
  2. From the navigation pane, click Migration to open the Migration projects view.
  3. From the top right-hand corner of the project panel, click the More Actions icon (3 dots). Then click Delete.

  4. You can also delete projects from the list view when you select one or more projects and click Delete.
  5. In the confirmation dialog that opens, click OK to confirm the deletion.

On Demand Migration Workspaces

Click Open Project in the tile view or click a project name in the list view, to open its project workspace. The project workspace displays important information about your project and associated reports. The project workspace contains the following tabs:

In each project, On Demand Migration also creates migration workspaces for each asset class selected for migration. These migration workspaces are logical collections of migration tools for the Office 365 assets and information about the assets in the source and target tenants.

You can go directly to the migration workspace of any asset by clicking the asset icon in the project tile. The icons you see will depend on your role, licenses and the assets selected when the project was created. You can hover over an icon to see the name of the asset type.


Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating