DMC (Dr Migrate Collector)
Prerequisites Checklist¶
Before proceeding with DMC deployment, ensure the following prerequisites are in place:
| Requirement | Learn More | |
|---|---|---|
| Complete Marketplace Infrastructure Setup. | Learn More | |
| Approve Required Resource Providers. | Learn More | |
| Enterprise Agreement pricing configured (if applicable). | Learn More |
Marketplace Infrastructure Setup¶
Permissions Required¶
Ideally the user performing the following steps should have the Global Administrator role.
If this is not possible, the least privileged approach requires the following permissions:
- Application Admin
- Groups Admin
- Subscription Owner
- Fabric Admin
- Marketplace Admin
- User Access Administrator
For more information about least privileged role assignment in Azure, see the Microsoft Learn Portal.
Create Service Principal¶
Dr Migrate requires a Service Principal to communicate with Azure Migrate.
Service Principal Creation Guidelines: * SPN Name: It is recommended to name the App Registration "drmigrate-spn" * Client Secret Creation: Dr Migrate requires a client secret with 12-month expiry recommended
Securely store the Client Secret value, as it is only viewable on creation and will be needed during the marketplace installation.
For Microsoft documentation on creating a Service Principal in Entra ID, see here.
Configure SPN Access¶
Best practice is to set up Dr Migrate in a dedicated Resource Group and/or Subscription. This provides a clear RBAC boundary and reduces Azure Policy conflicts.
The Azure Migrate project lifecycle is completely managed by Dr Migrate. It will be created automatically within the managed application resource group during deployment.
Assign your Service Principal the following permissions:
| Role | Scope | Reason Required | Requirement |
|---|---|---|---|
| Contributor | Resource Group where the managed application will be deployed | Required for Dr Migrate to create and manage Azure Migrate resources | Mandatory |
Approve Required Resource Providers¶
Dr Migrate requires specific Azure resource providers to be registered and approved in your subscription. These providers enable Dr Migrate to create and manage Azure Migrate resources within the managed application resource group.
Required Resource Providers: * Microsoft.OffAzure - Required for Azure Migrate discovery and assessment capabilities * Microsoft.Migrate - Required for Azure Migrate project management
To approve resource providers:
- Sign in to Azure Portal with a subscription owner account
- Navigate to Subscriptions and select the subscription where Dr Migrate will be deployed
- Open the Subscription > Resource Provider tab and find the required resource providers
- Search for and select each required provider: * Microsoft.OffAzure * Microsoft.Migrate
- Click Register for each provider
- Verify registration status shows as "Registered"
Resource provider registration typically completes within a few minutes. Ensure both providers show as "Registered" before proceeding with deployment.
The Azure Migrate project lifecycle is completely managed by Dr Migrate. It will be created automatically within the managed application resource group during deployment. No Azure Migrate appliances should be connected to this project.
Enable Cost Management Policy for EA Pricing¶
Enterprise Agreement Customers Only: Skip this section if you do not have an Enterprise Agreement with Microsoft. If you have an EA and want Dr Migrate to apply your agreed discounts when providing TCO costings, complete both requirements below.
After completing these prerequisites, you can sync your EA pricing through the TCO Config interface. See the Sync Enterprise Agreement Pricing guide for instructions.
Assign Cost Management Reader Role¶
Assign the Cost Management Reader role to your Service Principal:
| Role | Scope | Reason Required | Requirement |
|---|---|---|---|
| Cost Management Reader | Subscription where Dr Migrate will be deployed | Used to access customer specific price sheet | Required for EA pricing |
Enable Account Owners Can View Charges Policy¶
Complete these additional steps to enable EA pricing access:
- Sign in to Azure Portal with an Enterprise Administrator account
- Navigate to Cost Management + Billing
- Select your Billing Account
- Under Settings, choose Policies
- Set "Account owners can view charges" to On
This policy must be enabled by an Enterprise Administrator. Without this setting, the Cost Management Reader role alone will not provide access to EA pricing data.
Learn more about how to assign RBAC roles here.
Audit Azure Policy¶
When Dr Migrate installs, it deploys Azure resources to a managed Resource Group. These resources may be subject to Azure policy.
To mitigate deployment failures, temporarily exempt policies at the Subscription level that have the following effects:
- Append
- DeployIfNotExists
- Deny
- Modify
To learn how to exempt Azure Policy from resources, see here.
Azure Migrate Project Configuration¶
The Azure Migrate project is automatically created and managed by Dr Migrate within the managed application resource group. You do not need to create or configure an Azure Migrate project manually.
Review Azure Migrate Project Connectivity Method¶
The Azure Migrate project created by Dr Migrate is automatically configured with Public Endpoint connectivity mode.
If Private Endpoint must be used then additional configuration steps are required. See Private Endpoints for more information.
Microsoft also has documentation for those seeking further information, see here.
Azure Migrate Appliance Connection¶
Azure Migrate appliances must not be connected to the Azure Migrate project created by Dr Migrate. DMC does not currently support environments with Azure Migrate appliances.
Next Steps¶
After completing the prerequisites, you can: