|
2 | 2 | title: Azure Migrate appliance
|
3 | 3 | description: Provides an overview of the Azure Migrate appliance used in server assessment and migration.
|
4 | 4 | ms.topic: conceptual
|
5 |
| -ms.date: 03/23/2020 |
| 5 | +ms.date: 04/23/2020 |
6 | 6 | ---
|
7 | 7 |
|
8 | 8 |
|
@@ -297,12 +297,80 @@ Hyper-V Virtual Network Adapter | Bytes Sent/Second | Calculation for VM size
|
297 | 297 |
|
298 | 298 | ## Appliance upgrades
|
299 | 299 |
|
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 | +  |
| 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 | +  |
| 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 | +  |
| 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 | +  |
| 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. |
301 | 372 |
|
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. |
304 | 373 |
|
305 |
| - |
306 | 374 |
|
307 | 375 | ## Next steps
|
308 | 376 |
|
|
0 commit comments