Troubleshoot Azure Migrate
Troubleshoot common errors
Azure Migrate assesses on-premises workloads for migration to Azure. Use this article to troubleshoot issues when deploying and using Azure Migrate.
Migration project creation failed with error Requests must contain user identity headers
This issue can happen for users who do not have access to the Azure Active Directory (Azure AD) tenant of the organization. When a user is added to an Azure AD tenant for the first time, he/she receives an email invite to join the tenant. Users need to go to the email and accept the invitation to get successfully added to the tenant. If you are unable to see the email, reach out to a user who already has access to the tenant and ask them to resend the invitation to you using the steps specified here.
Once the invitation email is received, you need to open the email and click the link in the email to accept the invitation. Once this is done, you need to sign out of Azure portal and sign-in again, refreshing the browser will not work. You can then try creating the migration project.
Performance data for disks and networks adapters shows as zeros
This can occur if the statistics setting level on the vCenter server is set to less than three. At level three or higher, vCenter stores VM performance history for compute, storage, and network. For less than level three, vCenter doesn't store storage and network data, but CPU and memory data only. In this scenario, performance data shows as zero in Azure Migrate, and Azure Migrate provides size recommendation for disks and networks based on the metadata collected from the on-premises machines.
To enable collection of disk and network performance data, change the statistics settings level to three. Then, wait at least a day to discover your environment and assess it.
I installed agents and used the dependency visualization to create groups. Now post failover, the machines show "Install agent" action instead of "View dependencies"
- Post planned or unplanned failover, on-premises machines are turned off and equivalent machines are spun up in Azure. These machines acquire a different MAC address. They may acquire a different IP address based on whether the user chose to retain on-premises IP address or not. If both MAC and IP addresses differ, Azure Migrate does not associate the on-premises machines with any Service Map dependency data and asks user to install agents instead of viewing dependencies.
- Post test failover, the on-premises machines remain turned on as expected. Equivalent machines spun up in Azure acquire different MAC address and may acquire different IP address. Unless the user blocks outgoing Log Analytics traffic from these machines, Azure Migrate does not associate the on-premises machines with any Service Map dependency data and asks user to install agents instead of viewing dependencies.
I specified an Azure geography, while creating a migration project, how do I find out the exact Azure region where the discovered metadata would be stored?
You can go to the Essentials section in the Overview page of the project to identify the exact location where the metadata is stored. The location is selected randomly within the geography by Azure Migrate and you cannot modify it. If you want to create a project in a specific region only, you can use the REST APIs to create the migration project and pass the desired region.
Deployment of collector OVA failed
This could happen if the OVA is partially downloaded or due to the browser if you are using vSphere web client to deploy the OVA. Ensure that the download is complete and try deploying the OVA with a different browser.
Collector is not able to connect to the internet
This can happen when the machine you are using is behind a proxy. Make sure you provide the authorization credentials if the proxy needs one. If you are using any URL-based firewall proxy to control outbound connectivity, be sure to whitelist these required URLs:
|*.portal.azure.com||Required to check connectivity with the Azure service and validate time synchronization issues.|
|*.oneget.org||Required to download the powershell based vCenter PowerCLI module.|
The collector can't connect to the internet because of a certificate validation failure
This can happen if you are using an intercepting proxy to connect to the Internet, and if you have not imported the proxy certificate on to the collector VM. You can import the proxy certificate using the steps detailed here.
The collector can't connect to the project using the project ID and key I copied from the portal.
Make sure you've copied and pasted the right information. To troubleshoot, install the Microsoft Monitoring Agent (MMA) and verify if the MMA can connect to the project as follows:
- On the collector VM, download the MMA.
- To start the installation, double-click the downloaded file.
- In setup, on the Welcome page, click Next. On the License Terms page, click I Agree to accept the license.
- In Destination Folder, keep or modify the default installation folder > Next.
- In Agent Setup Options, select Azure Log Analytics > Next.
- Click Add to add a new Log Analytics workspace. Paste in project ID and key that you copied. Then click Next.
- Verify that the agent can connect to the project. If it can't, verify the settings. If the agent can connect but the collector can't, contact Support.
Error 802: Date and time synchronization error
The server clock might be out-of-synchronization with the current time by more than five minutes. Change the clock time on the collector VM to match the current time, as follows:
- Open an admin command prompt on the VM.
- To check the time zone, run w32tm /tz.
- To synchronize the time, run w32tm /resync.
VMware PowerCLI installation failed
Azure Migrate collector downloads PowerCLI and installs it on the appliance. Failure in PowerCLI installation could be due to unreachable endpoints for the PowerCLI repository. To troubleshoot, try manually installing PowerCLI in the collector VM using the following step:
- Open Windows PowerShell in administrator mode
- Go to the directory C:\ProgramFiles\ProfilerService\VMWare\Scripts\
- Run the script InstallPowerCLI.ps1
Error UnhandledException Internal error occured: System.IO.FileNotFoundException
This issue could occur due to an issue with VMware PowerCLI installation. Follow the below steps to resolve the issue:
- If you are not on the latest version of the collector appliance, upgrade your Collector to the latest version and check if the issue is resolved.
- If you already have the latest collector version, manually install VMware PowerCLI 6.5.2 and check if the issue is resolved.
- If the above does not resolve the issue, navigate to the C:\Program Files\ProfilerService folder and remove the VMware.dll and VimService65.dll files present in the folder and then restart the 'Azure Migrate Collector' service in Windows Services Manage (Open 'Run' and type 'services.msc' to open Windows Service Manager).
Unable to connect to vCenter Server "Servername.com:9443" due to error: There was no endpoint listening at https://Servername.com:9443/sdk that could accept the message.
Check if you are running the latest version of the collector appliance, if not, upgrade the appliance to the latest version.
If the issue still happens in the latest version, it could be because the collector machine is unable to resolve the vCenter Server name specified or the port specified is wrong. By default, if the port is not specified, collector will try to connect to the port number 443.
- Try to ping the Servername.com from the collector machine.
- If step 1 fails, try to connect to the vCenter server over IP address.
- Identify the correct port number to connect to the vCenter.
- Finally check if the vCenter server is up and running.
Troubleshoot dependency visualization issues
I installed the Microsoft Monitoring Agent (MMA) and the dependency agent on my on-premises VMs, but the dependencies are now showing up in the Azure Migrate portal.
Once you have installed the agents, Azure Migrate typically takes 15-30 mins to display the dependencies in the portal. If you have waited for more than 30 minutes, ensure that the MMA agent is able to talk to the OMS workspace by following the below steps:
For Windows VM:
- Go to Control Panel and launch Microsoft Monitoring Agent
- Go to the Azure Log Analytics (OMS) tab in the MMA properties pop-up
- Ensure that the Status for the workspace is green.
- If the status is not green, try removing the workspace and adding it again to MMA.
For Linux VM, ensure that the installation commands for MMA and dependency agent had succeeded.
What are the operating systems supported by MMA?
What are the operating systems supported by dependency agent?
I am unable to visualize dependencies in Azure Migrate for more than one hour duration?
Azure Migrate lets you visualize dependencies for up to one hour duration. Although, Azure Migrate allows you to go back to a particular date in the history for up to last one month, the maximum duration for which you can visualize the dependencies is up to 1 hour. For example, you can use the time duration functionality in the dependency map, to view dependencies for yesterday, but can only view it for a one hour window.
I am unable to visualize dependencies for groups with more than 10 VMs?
You can visualize dependencies for groups that have up to 10 VMs, if you have a group with more than 10 VMs, we recommend you to split the group in to smaller groups and visualize the dependencies.
Troubleshoot readiness issues
|Unsupported boot type||Azure does not support VMs with EFI boot type. It is recommended to convert the boot type to BIOS before you run a migration.
You can use Azure Site Recovery to do the migration of such VMs as it will convert the boot type of the VM to BIOS during the migration.
|Conditionally supported Windows OS||The OS has passed its end of support date and needs a Custom Support Agreement (CSA) for support in Azure, consider upgrading the OS before migrating to Azure.|
|Unsupported Windows OS||Azure supports only selected Windows OS versions, consider upgrading the OS of the machine before migrating to Azure.|
|Conditionally endorsed Linux OS||Azure endorses only selected Linux OS versions, consider upgrading the OS of the machine before migrating to Azure.|
|Unendorsed Linux OS||The machine may boot in Azure, but no OS support is provided by Azure, consider upgrading the OS to an endorsed Linux version before migrating to Azure|
|Unknown operating system||The operating system of the VM was specified as 'Other' in vCenter Server, due to which Azure Migrate cannot identify the Azure readiness of the VM. Ensure that the OS running inside the machine is supported by Azure before you migrate the machine.|
|Unsupported OS bitness||VMs with 32-bit OS may boot in Azure, but it is recommended to upgrade the OS of the VM from 32-bit to 64-bit before migrating to Azure.|
|Requires Visual Studio subscription.||The machines has a Windows client OS running inside it which is supported only in Visual Studio subscription.|
|VM not found for the required storage performance.||The storage performance (IOPS/throughput) required for the machine exceeds Azure VM support. Reduce storage requirements for the machine before migration.|
|VM not found for the required network performance.||The network performance (in/out) required for the machine exceeds Azure VM support. Reduce the networking requirements for the machine.|
|VM not found in specified pricing tier.||If the pricing tier is set to Standard, consider downsizing the VM before migrating to Azure. If the sizing tier is Basic, consider changing the pricing tier of the assessment to Standard.|
|VM not found in the specified location.||Use a different target location before migration.|
|One or more unsuitable disks.||One or more disks attached to the VM do not meet the Azure requirements. For each disk attached to the VM, ensure that the size of the disk is < 4 TB, if not, shrink the disk size before migrating to Azure. Ensure that the performance (IOPS/throughput) needed by each disk is supported by Azure managed virtual machine disks.|
|One or more unsuitable network adapters.||Remove unused network adapters from the machine before migration.|
|Disk count exceeds limit||Remove unused disks from the machine before migration.|
|Disk size exceeds limit||Azure supports disks with up to size 4 TB. Shrink disks to less than 4 TB before migration.|
|Disk unavailable in the specified location||Make sure the disk is in your target location before you migrate.|
|Disk unavailable for the specified redundancy||The disk should use the redundancy storage type defined in the assessment settings (LRS by default).|
|Could not determine disk suitability due to an internal error||Try creating a new assessment for the group.|
|VM with required cores and memory not found||Azure couldn't fine a suitable VM type. Reduce the memory and number of cores of the on-premises machine before you migrate.|
|Could not determine VM suitability due to an internal error.||Try creating a new assessment for the group.|
|Could not determine suitability for one or more disks due to an internal error.||Try creating a new assessment for the group.|
|Could not determine suitability for one or more network adapters due to an internal error.||Try creating a new assessment for the group.|
How do I collect logs on the collector VM?
Logging is enabled by default. Logs are located as follows:
To collect Event Tracing for Windows, do the following:
- On the collector VM, open a PowerShell command window.
- Run Get-EventLog -LogName Application | export-csv eventlog.csv.
How do I collect portal network traffic logs?
- Open the browser and navigate and log in to the portal.
- Press F12 to start the Developer Tools. If needed, clear the setting Clear entries on navigation.
- Click the Network tab, and start capturing network traffic:
- In Chrome, select Preserve log. The recording should start automatically. A red circle indicates that traffic is being capture. If it doesn't appear, click the black circle to start
- In Edge/IE, recording should start automatically. If it doesn't, click the green play button.
- Try to reproduce the error.
- After you've encountered the error while recording, stop recording, and save a copy of the recorded activity:
- In Chrome, right-click and click Save as HAR with content. This zips and exports the logs as a .har file.
- In Edge/IE, click the Export captured traffic icon. This zips and exports the log.
- Navigate to the Console tab to check for any warnings or errors. To save the console log:
- In Chrome, right-click anywhere in the console log. Select Save as, to export and zip the log.
- In Edge/IE, right-click on the errors and select Copy all.
- Close Developer Tools.
Collector error codes and recommended actions
|Error Code||Error name||Message||Possible causes||Recommended action|
|601||CollectorExpired||Collector has expired.||Collector Expired.||Please download a new version of collector and retry.|
|751||UnableToConnectToServer||Unable to connect to vCenter Server '%Name;' due to error: %ErrorMessage;||Check the error message for more details.||Resolve the issue and try again.|
|752||InvalidvCenterEndpoint||The server '%Name;' is not a vCenter Server.||Provide vCenter Server details.||Retry the operation with correct vCenter Server details.|
|753||InvalidLoginCredentials||Unable to connect to the vCenter Server '%Name;' due to error: %ErrorMessage;||Connection to the vCenter Server failed due to invalid login credentials.||Ensure that the login credentials provided are correct.|
|754||NoPerfDataAvaialable||Performance data not available.||Check Statistics Level in vCenter Server. It should be set to 3 for performance data to be available.||Change Statistics Level to 3 (for 5 minutes, 30 minutes, and 2 hours duration) and try after waiting at least for a day.|
|756||NullInstanceUUID||Encountered a machine with null InstanceUUID||vCenter Server may have an inappropriate object.||Resolve the issue and try again.|
|757||VMNotFound||Virtual machine is not found||Virtual machine may be deleted: %VMID;||Ensure that the virtual machines selected while scoping vCenter inventory exists during the discovery|
|758||GetPerfDataTimeout||VCenter request timed out. Message %Message;||vCenter Server credentials are incorrect||Check vCenter Server credentials and ensure that vCenter Server is reachable. Retry the operation. If the issue persists, contact support.|
|759||VmwareDllNotFound||VMWare.Vim DLL not found.||PowerCLI is not installed properly.||Please check if PowerCLI is installed properly. Retry the operation. If the issue persists, contact support.|
|800||ServiceError||Azure Migrate Collector service is not running.||Azure Migrate Collector service is not running.||Use services.msc to start the service and retry the operation.|
|801||PowerCLIError||VMware PowerCLI installation failed.||VMware PowerCLI installation failed.||Retry the operation. If the issue persists, install it manually and retry the operation.|
|802||TimeSyncError||Time is not in sync with the internet time server.||Time is not in sync with the internet time server.||Ensure that the time on the machine is accurately set for the machine's time zone and retry the operation.|
|702||OMSInvalidProjectKey||Invalid project key specified.||Invalid project key specified.||Retry the operation with correct project key.|
|703||OMSHttpRequestException||Error while sending request. Message %Message;||Check project ID and key and ensure that endpoint is reachable.||Retry the operation. If the issue persists, contact Microsoft Support.|
|704||OMSHttpRequestTimeoutException||HTTP request timed out. Message %Message;||Check project id and key and ensure that endpoint is reachable.||Retry the operation. If the issue persists, contact Microsoft Support.|