Skip to content

Commit 7ed3e1f

Browse files
Added a FAQ.
1 parent 4fb4bdd commit 7ed3e1f

15 files changed

+44
-1
lines changed

articles/migrate/common-questions-appliance.md

Lines changed: 44 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.manager: abhemraj
77
ms.service: azure-migrate
88
ms.topic: conceptual
99
ms.custom: engagement-fy24
10-
ms.date: 03/13/2024
10+
ms.date: 04/04/2024
1111
---
1212

1313
# Azure Migrate appliance: Common questions
@@ -147,6 +147,49 @@ By default, the appliance and its installed agents are updated automatically. Th
147147

148148
Only the appliance and the appliance agents are updated by these automatic updates. The operating system is not updated by Azure Migrate automatic updates. Use Windows Updates to keep the operating system up to date.
149149

150+
## How to troubleshoot Auto-update failures for Azure Migrate appliance?
151+
152+
A modification was made recently to the MSI validation process, which could potentially impact the Migrate appliance auto-update process. The auto-update process might fail with the following error message:
153+
154+
:::image type="content" source="./media/common-questions-appliance/auto-update-process-error-inline.png" alt-text="Screenshot of auto update process error." lightbox="./media/common-questions-appliance/auto-update-process-error-expanded.png":::
155+
156+
To fix this issue, follow these steps to ensure that your appliance can validate the digital signatures of the MSIs:
157+
158+
1. Ensure that the Microsoft’s root certificate authority certificate is present in your appliance’s certificate stores.
159+
1. Go to **Settings** and search for ‘certificates’.
160+
1. Select **Manage Computer Certificates**.
161+
162+
:::image type="content" source="./media/common-questions-appliance/settings-inline.png" alt-text="Screenshot of Windows settings." lightbox="./media/common-questions-appliance/settings-expanded.png":::
163+
164+
1. In the certificate manager, you must see the entry for **Microsoft Root Certificate Authority 2011** and **Microsoft Code Signing PCA 2011** as shown in the following screenshots:
165+
166+
:::image type="content" source="./media/common-questions-appliance/certificate-1-inline.png" alt-text="Screenshot of certificate 1." lightbox="./media/common-questions-appliance/certificate-1-expanded.png":::
167+
168+
:::image type="content" source="./media/common-questions-appliance/certificate-2-inline.png" alt-text="Screenshot of certificate 2." lightbox="./media/common-questions-appliance/certificate-2-expanded.png":::
169+
170+
1. If these two certificates are not present, proceed to download them from the following sources:
171+
- https://download.microsoft.com/download/2/4/8/248D8A62-FCCD-475C-85E7-6ED59520FC0F/MicrosoftRootCertificateAuthority2011.cer
172+
- https://www.microsoft.com/pkiops/certs/MicCodSigPCA2011_2011-07-08.crt
173+
1. install these certificates on the appliance machine.
174+
1. Check if there are any group policies on your machine that could be interfering with certificate validation:
175+
1. Go to Windows Start Menu > Run > gpedit.msc. <br>The **Local Group Policy Editor** window. Make sure that the **Network Retrieval** policies are defined as shown in the following screenshot:
176+
177+
:::image type="content" source="./media/common-questions-appliance/local-group-policy-editor-inline.png" alt-text="Screenshot of local group policy editor." lightbox="./media/common-questions-appliance/local-group-policy-editor-expanded.png":::
178+
179+
1. Ensure that there are no internet access issues or firewall settings interfering with the certificate validation.
180+
181+
**Verify Azure Migrate MSI Validation Readiness**
182+
183+
1. To ensure that your appliance is ready to validate Azure Migrate MSIs, follow these steps:
184+
1. Download a sample MSI from [Microsoft Download Center](https://download.microsoft.com/download/9/b/8/9b8abdb7-a784-4a25-9da7-31ce4d80a0c5/MicrosoftAzureAutoUpdate.msi) on the appliance.
185+
1. Right-click on it and go to Digital Signatures tab.
186+
187+
:::image type="content" source="./media/common-questions-appliance/digital-sign-inline.png" alt-text="Screenshot of digital signature tab." lightbox="./media/common-questions-appliance/digital-sign-expanded.png":::
188+
189+
1. Select Details and check that the Digital Signature Information for the certificate is OK as highlighted in the following screenshot:
190+
191+
:::image type="content" source="./media/common-questions-appliance/digital-sign-inline.png" alt-text="Screenshot of digital signature tab." lightbox="./media/common-questions-appliance/digital-sign-expanded.png":::
192+
150193
## Can I check agent health?
151194

152195
Yes. In the portal, go the **Agent health** page of the Azure Migrate: Discovery and assessment tool or the Migration and modernization tool. There, you can check the connection status between Azure and the discovery and assessment agents on the appliance.
140 KB
Loading
140 KB
Loading
118 KB
Loading
118 KB
Loading
103 KB
Loading
103 KB
Loading
61.3 KB
Loading
61.3 KB
Loading
47 KB
Loading

0 commit comments

Comments
 (0)