Skip to content

Commit 90cd832

Browse files
author
Manika Dhiman
committed
Changes to the registry key section
1 parent bd03494 commit 90cd832

File tree

4 files changed

+59
-40
lines changed

4 files changed

+59
-40
lines changed

‎azure-local/update/about-updates-23h2.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: ronmiab
55
ms.author: robess
66
ms.topic: overview
77
ms.reviewer: thoroet
8-
ms.date: 02/25/2025
8+
ms.date: 04/14/2025
99
---
1010

1111
# About updates for Azure Local
@@ -82,7 +82,7 @@ Solution updates managed by this feature contain new versions of the Azure Stack
8282
This solution is the recommended way to update your Azure Local.
8383

8484
> [!NOTE]
85-
85+
>
8686
> - Azure Local update includes updates for all components, including Azure CLI, PowerShell, and any extensions. Microsoft does not support out of band updates for individual components. The out of band updates could lead to incompatibility with Application Control for Windows.
8787
> - Customer workloads aren't covered by this update solution.
8888

‎azure-local/upgrade/upgrade-22h2-to-23h2-other-methods.md

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via other method
33
description: Learn how to upgrade from Azure Stack HCI OS, version 22H2 to version 23H2 using other manual methods on Azure Local.
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 03/14/2025
6+
ms.date: 04/14/2025
77
ms.author: alkohli
88
ms.reviewer: alkohli
99
ms.service: azure-local
@@ -51,20 +51,27 @@ Before you begin, make sure that:
5151

5252
## Step 0: Update registry keys
5353

54-
To avoid issues with Resilient File System (ReFS) during OS upgrade, run the following commands on each machine in the system to update registry keys:
54+
To ensure Resilient File System (ReFS) and live migrations function properly during and after OS upgrade, follow these steps on each machine in the system to update registry keys. Reboot each machine for the changes to take effect.
5555

56-
```powershell
57-
# Set RefsEnableMetadataValidation to 0
58-
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord -ErrorAction Stop
59-
```
56+
1. Set `RefsEnableMetadataValidation` to `0`:
6057

61-
```powershell
62-
# Create the parameters key if it does not exist. If it does already exist, the command may fail with an error, which is expected.
63-
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
58+
```powershell
59+
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord -ErrorAction Stop
60+
```
61+
62+
1. Create the parameters key if it doesn't exist. If it already exists, the command may fail with an error, which is expected.
63+
64+
```powershell
65+
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
66+
```
67+
68+
1. Set `SkipSmallLocalAllocations` to `0`:
69+
70+
```powershell
71+
New-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters -Name SkipSmallLocalAllocations -Value 0 -PropertyType DWord
72+
```
6473

65-
# Set the SkipSmallLocalAllocations value to 0
66-
New-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters -Name SkipSmallLocalAllocations -Value 0 -PropertyType DWord
67-
```
74+
1. Restart the machine for the changes to take effect. On machine restart, if the `RefsEnableMetadataValidation` key gets overridden and ReFS volumes fail to come online, toggle the key by first setting `RefsEnableMetadataValidation` to `1` and then back to `0` again.
6875

6976
## Step 1: Connect to your system
7077

‎azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md

Lines changed: 19 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via PowerShell
33
description: Learn how to use PowerShell to upgrade Azure Stack HCI OS, version 22H2 to version 23H2.
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 03/14/2025
6+
ms.date: 04/14/2025
77
ms.author: alkohli
88
ms.reviewer: alkohli
99
ms.service: azure-local
@@ -52,24 +52,29 @@ Before you begin, make sure that:
5252
> The ISO file is only required if the machines do not have access to Windows Update to download the OS feature update. If using this method, after you [Connect to Azure Local, version 22H2](#step-1-connect-to-azure-local), skip to step 6 under [Step 2: Install new OS using PowerShell](#step-2-install-new-os-using-powershell) and perform the remaining steps.
5353
> Use of 3rd party tools to install upgrades is not supported.
5454
55-
Follow these steps to install the solution upgrade:
56-
5755
## Step 0: Update registry keys
5856

59-
To avoid issues with Resilient File System (ReFS) during OS upgrade, run the following commands on each machine in the system to update registry keys:
57+
To ensure Resilient File System (ReFS) and live migrations function properly during and after OS upgrade, follow these steps on each machine in the system to update registry keys. Reboot each machine for the changes to take effect.
6058

61-
```powershell
62-
# Set RefsEnableMetadataValidation to 0
63-
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord -ErrorAction Stop
64-
```
59+
1. Set `RefsEnableMetadataValidation` to `0`:
6560

66-
```powershell
67-
# Create the parameters key if it does not exist. If it does already exist, the command may fail with an error, which is expected.
68-
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
61+
```powershell
62+
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord -ErrorAction Stop
63+
```
6964

70-
# Set the SkipSmallLocalAllocations value to 0
71-
New-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters -Name SkipSmallLocalAllocations -Value 0 -PropertyType DWord
72-
```
65+
1. Create the parameters key if it doesn't exist. If it already exists, the command may fail with an error, which is expected.
66+
67+
```powershell
68+
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
69+
```
70+
71+
1. Set `SkipSmallLocalAllocations` to `0`:
72+
73+
```powershell
74+
New-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters -Name SkipSmallLocalAllocations -Value 0 -PropertyType DWord
75+
```
76+
77+
1. Restart the machine for the changes to take effect. On machine restart, if the `RefsEnableMetadataValidation` key gets overridden and ReFS volumes fail to come online, toggle the key by first setting `RefsEnableMetadataValidation` to `1` and then back to `0` again.
7378

7479
## Step 1: Connect to Azure Local
7580

‎azure-local/upgrade/upgrade-22h2-to-23h2-windows-admin-center.md

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via Windows Admi
33
description: Learn how to upgrade Azure Stack HCI OS, version 22H2 to version 23H2 using Windows Admin Center.
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 03/14/2025
6+
ms.date: 04/14/2025
77
ms.author: alkohli
88
ms.reviewer: alkohli
99
ms.service: azure-local
@@ -52,20 +52,27 @@ Before you begin, make sure that:
5252
5353
## Step 0: Update registry keys
5454

55-
To avoid issues with Resilient File System (ReFS) during OS upgrade, run the following commands on each machine in the system to update registry keys:
55+
To ensure Resilient File System (ReFS) and live migrations function properly during and after OS upgrade, follow these steps on each machine in the system to update registry keys. Reboot each machine for the changes to take effect.
5656

57-
```powershell
58-
# Set RefsEnableMetadataValidation to 0
59-
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord -ErrorAction Stop
60-
```
57+
1. Set `RefsEnableMetadataValidation` to `0`:
6158

62-
```powershell
63-
# Create the parameters key if it does not exist. If it does already exist, the command may fail with an error, which is expected.
64-
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
59+
```powershell
60+
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord -ErrorAction Stop
61+
```
6562

66-
# Set the SkipSmallLocalAllocations value to 0
67-
New-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters -Name SkipSmallLocalAllocations -Value 0 -PropertyType DWord
68-
```
63+
1. Create the parameters key if it doesn't exist. If it already exists, the command may fail with an error, which is expected.
64+
65+
```powershell
66+
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
67+
```
68+
69+
1. Set `SkipSmallLocalAllocations` to `0`:
70+
71+
```powershell
72+
New-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters -Name SkipSmallLocalAllocations -Value 0 -PropertyType DWord
73+
```
74+
75+
1. Restart the machine for the changes to take effect. On machine restart, if the `RefsEnableMetadataValidation` key gets overridden and ReFS volumes fail to come online, toggle the key by first setting `RefsEnableMetadataValidation` to `1` and then back to `0` again.
6976

7077
## Step 1: Connect to Azure Local via Windows Admin Center
7178

0 commit comments

Comments
 (0)