System requirements
Before you begin a migration project and agent deployment, ensure that your systems meet the following minimum requirements.
General Requirements
- Client has been licensed for On Demand Migration.
- Access to a Global Administrator account for each Microsoft 365 tenant.
- Disable policies that prevent Outlook Profile, OneDrive for Business, and Microsoft Teams application changes or creation.
- If applicable, users have been provided new or temporary password for the account in the new target destination Microsoft 365 tenant.
- Source and target users have matching attribute values to identify and pair objects together for mailbox and OneDrive content synchronization.
|
TIP: Try Password Sync for On Demand Migration Active Directory to keep your migrated hybrid users synchronized so when they are moved, they keep their existing password. |
License Requirements
Before starting a migration, each target user account must be licensed for each application that will be reconfigured using Desktop Update Agent. The following licenses are required:
- Exchange Online if configuring Outlook profiles.
- SharePoint Online if configuring OneDrive for Business application.
- Microsoft Teams if configuring Microsoft Teams application.
|
NOTE: On Demand Migration can automatically assign these licenses to target user accounts during the email and OneDrive migration process. |
Software Requirements
|
NOTE: If OneDrive for Business, Microsoft Teams, Outlook, or Office are not installed on the workstation, those applications will be skipped and not impact any other applications present during the reconfiguration. |
The minimum version requirements for software installed on user’s workstations:
- Outlook 2016 (32-bit or 64-bit) or higher
- OneDrive for Business (Most recent updates recommended)
- Microsoft Teams
- Windows 10 (32-bit or 64-bit) or Windows 11
- .NET 4.7.2 or higher
- Microsoft 365 Apps (Office Click-to-Run Version Only)
|
NOTE:
|
Network Requirements
The minimum network requirements to run Desktop Update Agent:
|
NOTE: During this process, the Outlook Profile will be copied to a new Profile directed to the target account. Due to this configuration, a new OST download will occur based on each user's current cache settings, if enabled. To avoid network congestion try disabling or curtailing the cache settings to a lower amount of data then slowly increase it as needed. This can be accomplished through policies. |
Supported Authentication
On Demand Migration Desktop Update Agent supports environments that use:
- Active Directory Federation Services (AD FS)
- Single Sign On (SSO) with mixed authentication modes, such as:
- Modern Authentication (ADAL)
- Forms Authentication
- Windows Integrated Authentication
Localization
In this release, supported languages for the Desktop Update Agent include English, Chinese (Simplified), French, German, Japanese, and Spanish.
FAQs
The following is a list of frequently asked questions for On Demand Migration Desktop Update Agent.
- Question: Does DUA support multiple accounts in a single Outlook profile?
Answer: Currently DUA does not support reconfiguring Outlook when multiple mailbox accounts are associated with a single profile. Each additional mailbox must be added manually.
-
Question: How does DUA preserve the OneDrive folder and why was my source folder renamed?
Answer: Microsoft OneDrive for Business automatically sets the local folder name as “OneDrive – [OrganizationName]” where OrganizationName is the tenant organization name. This is the default folder name format cannot be changed.
To preserve the source OneDrive local folder, DUA must disconnect the source account and rename the folder based on the target tenant’s organization name. For example, if the target tenant’s Organization Name is XYZCorp, the folder will be renamed to “OneDrive – XYZCorp”.
- Question: Will the end-user’s synchronized local SharePoint folders be preserved when the Preserve Source OneDrive Folder option is enabled?
Answer: Users must re-sync their local SharePoint folders after DUA has disconnected the source OneDrive account and added the target OneDrive account on their workstation.
Local SharePoint folder syncs connected to the source OneDrive account are not preserved.
The migration administrator must validate that SharePoint migrations are completed succesfully to ensure users have access to the target tenant’s SharePoint sites.
-
Question: What happens if several Switch Tasks have been created? For example, can we create separate tasks for each type of application?
Answer: Desktop Update Agent acts on the most recent switch task. Previously created tasks are not processed by the agent.
-
Question: How do I silently deploy Desktop Update Agent using a Command Line script?
Answer: To deploy DUA using a command line, use the following procedure:
1. Download the Desktop Update Agent MSI file from the Downloads page. (The Token Key value found on the Downloads page and the Passphrase used when generating the token are required.)
2. Create and run the PowerShell command with the required Token (Token Value) and Passphrase (Passphrase Value) values. For example: msiexec.exe /I 'C:\DUA\ODM_DesktopUpdateAgent 2.0.msi' TOKEN=######## PASSPHRASE=##### /qn
-
Question: Desktop Update Agent cannot retrieve my user email address information when running, and the DUA agent log reports a message similar to "AADSTS500021: Access to 'Quest' tenant is denied." How can I fix this?
Answer:Desktop Update Agent needs to communicate with the On Demand Migration API to perform the application reconfiguration, and the API is secured by Microsoft Entra ID through a Quest Software tenant. If your network restricts access to Azure Active Directorty tenants, DUA cannot find the user's email information, and the DUA agent log reports a message similar to "AADSTS500021: Access to 'Quest' tenant is denied.". Ensure that the Quest tenant "quest.com"/91c369b5-1c9e-439c-989c-1867ec606603 is added to the permitted tenant list. Additional details related to Tenant Restriction Configuration can be found in Microsoft documentation.
Product Licensing
Quest On Demand is a Software as a Service (SaaS) application where application software is hosted in the cloud and made available to users through quest-on-demand.com.
Use of this software is governed by the Software Transaction Agreement found at www.quest.com/legal/sta.aspx and the SaaS Addendum at www.quest.com/legal/saas-addendum.aspx. This software does not require an activation or license key to operate.
You can sign in to Quest On Demand with a trial license, add your Microsoft Entra tenant, and sample the solutions the product can offer.
To enable a trial license with an existing Quest account
- Go to https://www.quest.com/on-demand/
- Scroll to the module you are interested in and click Try Online.
- On the Free Trial of <Module Name> page, accept the license agreement, and click Sign In for your Free Trial .
- Click Sign in with Microsoft.
- Select your account in the upper right corner and enter a name for your Quest On Demand organization.
- In the Select Region field, select the region where you want your data to reside.
- Click Create New Organization.
You can now add your Microsoft Entra tenant and begin using the module. See the Global Settings User Guide for more information on working with Quest On Demand.
To create a Quest account and enable a trial license
- Go to https://www.quest.com/on-demand/
- Scroll to the module you are interested in and click Try Online.
- Accept the license agreement and click Create a Trial Account.
-
Fill in the fields on the Create Account page and click Sign Up. Note that the email and password entered here will be the credentials you use to sign in to On Demand.
-
You will receive an email from support.quest.com. Click the Start your free trial link.
-
Sign in to On Demand with your Quest account or with Microsoft.
- Select your account in the upper right corner and enter a name for your Quest On Demand organization.
- In the Select Region field, select the region where you want your data to reside.
- Click Create New Organization.
You can now add your Microsoft Entra tenant and begin using the module. See the Global Settings User Guide for more information on working with Quest On Demand.
|
NOTE: You can also manage subscriptions from within the On Demand application through Settings | Subscriptions. |