Chat now with support
Chat with Support

Welcome, Quadrotech customers to Quest Support Portal click here for for frequently asked questions regarding servicing your supported assets.

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 Hybrid Account Migration Domain Coexistence Mail Migration OneDrive Migration Resource Processing Public Folders Migration SharePoint Migration Microsoft Teams Migration Content Migration for Office 365 Groups Troubleshooting Finalizing the Migration

Deploying Migration Manager for Active Directory

Prerequisites
  • On-premises administrative account used for integration should have all required permissions specified in System Requirements and Access Rights document for administrative account and should have write permission to the project database.

IMPORTANT: Extended Active Directory schema with Exchange attributes in the target is required in case of target on-premises environment without Exchange Server.

  • Quest Migration Manager version 8.14 with Product Update 20190218 or above.
  • Windows PowerShell 2.0
  • .Net Framework 2.0
Installation Requirements
  1. When prompted, specify your name and company. Click Licenses to verify your license information in the dialog displayed: browse for a valid license file, and then click Close.
  2. Next, on the Select Features step, select the Migration Manager for Active Directory only excluding all other components and sub-components.
  3. On the next step, select Express option of the product installation scenario. Express means that setup will do the following:
    • Installs all the components that are permitted by the license file.
    • Installs all other required components, such as the AD LDS or ADAM instance, SQL Server, and the Directory Synchronization Agent.
    • Configures default migration project.
  • Refer to Quest Migration Manager documentation for installation instructions and for system requirements and access rights required to for Quest Migration Manager.
  • Caution: Migration Manager installation should not be performed while some system updates are installed or configured.

  • Configuring Hybrid

    1. Click Configure on Hybrid widget on Project Dashboard to open Configure Hybrid dialog.
    2. Click Get Service button to download Quest Hybrid Migration Service and install it on the same machine where Quest Migration Manager is deployed.
    3. Click Get secret button to download the secret for integrating On Demand Migration with Quest Migration Manager. The downloaded onpremservicekey.txt file should be moved to %CommonProgramFiles(x86)%\Aelita Shared\Migration Tools\Relay folder.
      If you suspect the secret is compromised, re-issue it through Configure Hybrid dialog. The previously issued secret will be immediately revoked and the hybrid connection will be suspended until you replace the file in %CommonProgramFiles(x86)%\Aelita Shared\Migration Tools\Relay folder.

    NOTE: The same secret can be used for all migration projects created for one organization, provided that the Quest Hybrid Migration Service is installed on only one machine.

    1. Click Next.
    2. Provide the source Domain or Domain Controller FQDN and administrative account credentials for your source on-premises environment. Click Save to proceed.
    3. Provide the target Domain or Domain Controller FQDN and administrative account credentials your target on-premises environment.
    1. Configure advanced options, in case you have migration projects for more than one tenant pair. Provide the custom directory attributes (service attributes) for storing service information and conflict resolution. It is reasonable to specify only attributes that are not currently used in target environment. Refer to Service Attributes subsection of Quest Migration Manager documentation for more details. Click Save to proceed.
    2. Click Next.
    3. Select Turn On the hybrid migration option to enable Hybrid Migration for this migration project. Click Finish.

    TIP: You can turn off hybrid whenever you no longer need it. On Demand Migration returns to usual cloud-only migration mode

    1. Hybrid widget displays whether connections are configured and hybrid is enabled. If both status icons are green, run the discovery task to enumerate all hybrid users and groups.

    Installing Hybrid Migration Service

    To install Hybrid Migration Service, run the downloaded file.

    1. Accept the license agreement. Click Next.
    2. Provide the administrative account with write permissions for ADAM / AD LDS server used by Quest Migration Manager.

    Matching Hybrid Accounts

    Caution:

    • Don’t start the matching task before the discovery task is finished
    • All hybrid account that were matched before hybrid is configured and enabled should be re-matched

    Your target tenant might already contain accounts created for the source tenant users. You can map them to the corresponding source accounts to avoid duplication in the target. Create Matching Task:

    1. Go to the migration project Dashboard in case you use new migration UI. In case you are using classic experience or you are already on the account migration Dashboard, go to step 3.
    2. Click Accounts widget.
    1. Open Accounts.
    2. Select the hybrid accounts you want to match and click Match Accounts.

    TIP: Use Searching, Filtering or Using Collections to quickly navigate through the list of accounts. Environment filter help you to select users synchronized with Active Directory.

    1. Select Match by attributes and select the source and target attributes. The following attributes are supported:
      • displayName
      • mail
      • mailNickName
      • immutableId
      • employeeId

    NOTE: The matching is performed by synchronized on-premises account attributes.

    Click Next to proceed.

    1. Schedule when the task will be started. See Task Scheduling for details. Click Next to view the task summary.
    2. Check the matching rule, scheduled start of the task and name the task. Click Finish to save or start the task depending on schedule option selected.

    The matching task is created. You can track its progress in the Tasks, view the summary on the Project Dashboard or monitor alerts and notifications in the Events.

    When the task is finished, encrypted information about matching is written in the custom directory attributes (service attributes) of the target accounts. See Configuring Hybrid for details.

    Related Documents