Skip to content

Commit 5e3c6b8

Browse files
committedAug 9, 2021
New article, added images, updated toc
1 parent d1a51d8 commit 5e3c6b8

File tree

6 files changed

+67
-0
lines changed

6 files changed

+67
-0
lines changed
 
Loading
Loading
Loading

‎articles/migrate/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -244,6 +244,8 @@
244244
items:
245245
- name: Troubleshoot Azure Migrate appliance
246246
href: troubleshoot-appliance.md
247+
- name: Troubleshoot appliance diagnostics
248+
href: troubleshoot-appliance-diagnostic.md
247249
- name: Troubleshoot discovery
248250
href: troubleshoot-discovery.md
249251
- name: Troubleshoot dependency visualization
Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
title: Troubleshoot Azure Migrate appliance diagnostic
3+
description: Get help to diagnose and troubleshoot problems that might occur with the Azure Migrate appliance.
4+
author: Vikram1988
5+
ms.author: vibansa
6+
ms.manager: abhemraj
7+
ms.topic: troubleshooting
8+
ms.date: 08/09/2021
9+
---
10+
11+
# Diagnose and solve issues with Azure Migrate appliance
12+
13+
The **Diagnose and solve** capability on Azure Migrate appliance helps users identify and self-assess any issues with the appliance configuration that might be blocking the initiation of discovery or issues with an ongoing Migrate operation like discovery, assessment and/or replication (*in case of VMware appliance*) from the appliance.
14+
15+
You can run **Diagnose and solve** at any time from the appliance configuration manager to generate a diagnostics report. The report provides information about the checks performed, their status, the issues identified and recommendation steps to solve the issues.
16+
17+
## Diagnostic checks
18+
19+
*Diagnose and solve* runs some pre-validations to see if the required configuration files are not missing or blocked by an anti-virus software on the appliance and then performs the following checks:
20+
21+
**Category** | **Diagnostics check** |**Description**
22+
--- | --- | --- |
23+
**Prerequisite checks** | Connectivity checks | Checks if the appliance has connectivity to Azure either directly or via proxy.
24+
|| Time sync check | Checks if the appliance server time is in sync with network time.
25+
|| Auto update check | Checks if auto-update is enabled and if all agents running on the appliance are up to date.
26+
||VDDK check | Checks if the required VDDK files have been downloaded and copied at the required location on the appliance server
27+
**Service health checks** |Operational status |Checks if the agents on the appliance are in running state. <br>*If not, appliance will auto-resolve by restarting the agents.*
28+
||Service endpoint connectivity |Checks if the agents can communicate to their respective services on Azure either directly or via proxy.
29+
**Azure-specific checks** |AAD App availability | Checks if the AAD App created during the appliance registration is available and is accessible from the appliance.
30+
||Migrate project availability | Checks if the Migrate project to which the appliance has been registered still exists and is accessible from the appliance.
31+
||Essential resources availability| Checks if the Migrate resources created during appliance registration still exist and are accessible from the appliance.
32+
**Appliance-specific checks | Key Vault certificate availability | Checks if the certificate downloaded from Key Vault during appliance registration is still available on the appliance server. <br> *If not, appliance will auto-resolve by downloading the certificate again, provided the Key Vault is available and accessible*
33+
|| Credential store availability | Checks if the Credential store resources on the appliance server have not been moved/deleted/edited.
34+
|| Replication appliance/ASR components | Checks if the same server has also been used to install any ASR/replication appliance components. *It is currently not supported to install both Azure Migrate and replication appliance (for agent-based migration) on the same server.*
35+
|| OS license availability | Checks if the evaluation license on the appliance server created from OVA/VHD is still valid. *The Windows Server 2016 evaluation license is valid for 180 days.*
36+
|| CPU & memory utilization | Checks the CPU and memory utilized by the Migrate agents on the appliance server. <br> *checked and reported only if the appliance has already been registered. These checks are run in the context of the current Azure user logged in the appliance.*
37+
38+
## Running diagnostic checks
39+
40+
If you are getting any issues with the appliance during its configuration or seeing issues with the ongoing Migrate operations like discovery, assessment and/or replication (*in case of VMware appliance*) on the portal, you can go to the appliance configuration manager and run diagnostics.
41+
42+
> [!NOTE]
43+
Currently **Diagnose and solve** can perform checks related to appliance connectivity to Azure, availability of required resources on appliance server and/or Azure. The connectivity or discovery issues with the source environment like vCenter Server/ESXi hosts/Hyper-V hosts/VMs/physical servers are currently not covered under **Diagnose and solve*.
44+
45+
1. Select **Diagnose and solve** from the ribbon at the top of the configuration manager
46+
47+
![Select diagnose and solve](./media/troubleshoot-appliance-diagnostic-solve/appliance-configuration-manager-diagnose-solve.png)
48+
49+
After selecting **Diagnose and solve**, the appliance automatically starts running the diagnostic checks. This may take around 5 minutes to complete.
50+
*You would see the timestamp of the last diagnostics report, if you ran the checks before.*
51+
52+
![Diagnostic report](./media/troubleshoot-appliance-diagnostic-solve/diagnostic-report.png)
53+
54+
1. Once diagnostic checks have completed, you can either view the report in another tab where you can choose it save it in a PDF format or you can go to this location-**C:\Users\Public\Desktop\DiagnosticsReport** on the appliance server where the report gets auto-saved in an HTML format.
55+
56+
![View diagnostic report](./media/troubleshoot-appliance-diagnostic-solve/view-diagnostic-report.png)
57+
58+
1. The report provides information about the checks performed, their status, the issues identified, and recommendation steps to solve the issues.
59+
60+
![View status of diagnostic report](./media/troubleshoot-appliance-diagnostic-solve/view-status.png)
61+
62+
1. You can follow the remediation steps on the report to solve an issue. If you are unable to resolve the issue, it is recommended that you attach the diagnostics report while creating a Microsoft support case so that it helps expedite the resolution.
63+
64+
## Next steps
65+
If you are getting issues not covered under **Diagnose and solve**, you can go to [troubleshoot the Azure Migrate appliance](/azure/migrate/troubleshoot-appliance.md) to find the remediation steps.

0 commit comments

Comments
 (0)
Please sign in to comment.