About this Guide
On Demand Migration is a Microsoft 365 tenant-to-tenant migration service that allows you to simply and securely migrate Microsoft 365 information from Exchange Online, OneDrive for Business, SharePoint Online, and Microsoft Teams. To complete a migration project, agents must be configured and deployed by administrators or downloaded directly by end users (as configured for your project). In either case, the agent will run on end users' workstations.
The purpose of this guide is to:
- provide the information administrators require to configure and deploy agents for a migration project.
- provide the steps users must perform to reconfigure their applications and complete the migration process.
- provide a high-level overview of a migration project from the administrators configuration tasks to the users application reconfiguration tasks.
For complete details on setting up a migration project, refer to the On Demand Migration User Guide.
System requirements
Before installing 1.2.1, ensure that your system meets the minimum hardware and software requirements. See the On Demand Migration Update Agent Release Notes for details.
On Demand Migration Agent Deployment
To complete a migration project and reconfigure a user's applications, agents must be configured and deployed by administrators, then run on users' workstations or by user using the direct download link. In most projects, only one of the following agent types is available:
- Client Update Agent (CUA) which enables users to automatically reconfigure their existing Microsoft Outlook Profile to connect to their new home tenant.
See Working with On Demand Migration Client Update Agent (CUA) for deployment details.
- Desktop Update Agent (DUA) which provides enhanced support, helps ensure the success of cross-tenant migration projects, makes agent delivery easier, and improves status reporting.
See Working with On Demand Migration Desktop Update Agent (DUA) for deployment details.
Working with On Demand Migration Client Update Agent (CUA)
Client Update Agent is a utility provided with On Demand Migration that automatically switches users to newly migrated mailboxes as part of a migration project. The migration administrator downloads the agent, then deploys the agent to the required user workstations.
This is a viable option, however, it does not provide the enhanced agent deployment capabilities available with Desktop Update Agent. See Working with On Demand Migration Desktop Update Agent (DUA) for details.
Downloading Client Update Agent
|
|
IMPORTANT: The Client Update Agent package comes with the certificate for securing connections between the agent and On Demand Migration. If you suspect that the certificate is compromised, download the package again, selecting Reissue the certificate option. The previously issued certificate will be immediately revoked. |
To download Client Update Agent:
- Go to the migration project Dashboard.
- Select Accounts
- Go to the
- Select Download.
Deploying Client Update Agent
The Client Update Agent package checks the migration status and runs the odmclient.exe and the certificate for securing connections between the agent and On Demand Migration certificate.pfx.
To automatically distribute the agent across all clients:
- Deploy the certificate to all end-user computers with Group Policy.
See https://docs.microsoft.com/en-us/windows-server/identity/ad-fs/deployment/distribute-certificates-to-client-computers-by-using-group-policy for details.
- Create a log in script for client computers.
For detailed information on command-line parameters, see the document (readme.txt) that comes with the package.