Skip to content

Commit fba7e5d

Browse files
authored
Merge pull request #112448 from rayne-wiselman/rayneapril23
updating urgent support info
2 parents f3ea47d + ccea127 commit fba7e5d

File tree

5 files changed

+73
-5
lines changed

5 files changed

+73
-5
lines changed
113 KB
Loading
139 KB
Loading
60.1 KB
Loading
64.9 KB
Loading

articles/migrate/migrate-appliance.md

Lines changed: 73 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Azure Migrate appliance
33
description: Provides an overview of the Azure Migrate appliance used in server assessment and migration.
44
ms.topic: conceptual
5-
ms.date: 03/23/2020
5+
ms.date: 04/23/2020
66
---
77

88

@@ -297,12 +297,80 @@ Hyper-V Virtual Network Adapter | Bytes Sent/Second | Calculation for VM size
297297

298298
## Appliance upgrades
299299

300-
The appliance is upgraded as the Azure Migrate agents running on the appliance are updated. This happens automatically because auto-update is enabled on the appliance by default. You can change this default setting to update the agents manually.
300+
The appliance is upgraded as the Azure Migrate agents running on the appliance are updated. This happens automatically, because auto-update is enabled on the appliance by default. You can change this default setting, to update the appliance services manually.
301+
302+
### Turn off auto-update
303+
304+
1. On the machine running the appliance, open the Registry Editor.
305+
2. Navigate to **HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureAppliance**.
306+
3. To turn off auto-update, create a registry key **AutoUpdate** key with DWORD value of 0.
307+
308+
![Set registry key](./media/migrate-appliance/registry-key.png)
309+
310+
311+
### Turn on auto-update
312+
313+
You can turn on auto-update using either of these methods:
314+
315+
- By deleting the AutoUpdate registry key from HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureAppliance.
316+
- After discovery is complete, in the Appliance Configuration Manager.
317+
318+
To delete the registry key:
319+
320+
1. On the machine running the appliance, open the Registry Editor.
321+
2. Navigate to **HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureAppliance**.
322+
3. Delete the registry key **AutoUpdate**, that was previously created to turn off auto-update.
323+
324+
To turn on from Appliance Configuration Manager, after discovery is complete:
325+
326+
1. On the appliance machine, open the Appliance Configuration Manager.
327+
2. In **Appliance services** > **Automatic update of Azure Migrate components is turned off**, click to turn on auto-update.
328+
329+
![Turn on auto updates](./media/migrate-appliance/turn-on.png)
330+
331+
### Check the appliance services version
332+
333+
You can check the appliance services version using either of these methods:
334+
335+
- In Appliance Configuration Manager, after discovery is complete.
336+
- On the appliance machine, in the **Control Panel** > **Programs and Features**.
337+
338+
To check in the Appliance Configuration Manager:
339+
340+
1. After discovery is complete, open Appliance Configuration Manager (in the appliance web app).
341+
2. In **Appliance services**, verify the appliance services versions.
342+
343+
![Check version](./media/migrate-appliance/version.png)
344+
345+
To check in the Control Panel:
346+
347+
1. On the appliance, click **Start** > **Control Panel** > **Programs and Features**
348+
2. Check the appliance services versions in the list.
349+
350+
![Check version in Control Panel](./media/migrate-appliance/programs-features.png)
351+
352+
### Manually update an older version
353+
354+
If you are running an older version for any of the components, you must uninstall the service, and manually update to the latest version.
355+
356+
1. To check for the latest appliance service versions, [download](https://aka.ms/latestapplianceservices) the LatestComponents.json file.
357+
2. After downloading, open the LatestComponents.json file in Notepad.
358+
3. Find the latest service version in the file, and the download link for it. For example:
359+
360+
"Name": "ASRMigrationWebApp", "DownloadLink": "https://download.microsoft.com/download/f/3/4/f34b2eb9-cc8d-4978-9ffb-17321ad9b7ed/MicrosoftAzureApplianceConfigurationManager.msi", "Version": "6.0.211.2", "Md5Hash": "e00a742acc35e78a64a6a81e75469b84"
361+
362+
4. Download the latest version of an outdated service, using the download link in the file.
363+
5. After downloading, run the following command in an administrator command window, to verify the integrity of the downloaded MSI.
364+
365+
``` C:\>Get-FileHash -Path <file_location> -Algorithm [Hashing Algorithm] ```
366+
For example:
367+
C:\>CertUtil -HashFile C:\Users\public\downloads\MicrosoftAzureApplianceConfigurationManager.MSI MD5
368+
369+
5. Check that the command output matches the hash value entry for the service in the file (for example, the MD5 hash value above).
370+
6. Now, run the MSI to install the service. It's a silent install, and the installation window closes after it's done.
371+
7. After installation is complete, check the version of the service in **Control panel** > **Programs and Features**. The service version should now be upgraded to the latest shown in the json file.
301372

302-
- **Turn off auto-update**: You turn off auto-update in the registry by setting HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureAppliance "AutoUpdate" key to 0 (DWORD). If you decide to use manual updates, it's important to update all agents on the appliance at the same time, using the **Update** button for each outdated agent on the appliance.
303-
- **Update manually**: For manual updates, make sure that you update all the agents on the appliance, using the **Update** button for each outdated agent on the appliance. You can switch the update setting back to automatic updates at any time.
304373

305-
![Automatically update appliance](./media/migrate-appliance/autoupdate.png)
306374

307375
## Next steps
308376

0 commit comments

Comments
 (0)