Skip to content

Commit 05ff0df

Browse files
author
Manika Dhiman
committed
Added updates
1 parent 191166b commit 05ff0df

File tree

1 file changed

+47
-2
lines changed

1 file changed

+47
-2
lines changed

azure-local/upgrade/upgrade-to-24h2-powershell.md

Lines changed: 47 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS to version 26100.xxxx using PowerShell
33
description: Learn how to use PowerShell to upgrade Azure Stack HCI OS to version 26100.xxxx.
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 06/02/2025
6+
ms.date: 06/05/2025
77
ms.author: alkohli
88
ms.reviewer: alkohli
99
ms.service: azure-local
@@ -42,6 +42,11 @@ To upgrade the OS on your system, follow these high-level steps:
4242
- Make sure to shut down virtual machines (VMs). We recommend shutting down VMs before performing the OS upgrade to prevent unexpected outages and damages to databases.
4343
- Confirm that you have access to the Azure Local **2505** ISO file, which you can download from the [Azure portal](https://portal.azure.com/#view/Microsoft_Azure_ArcCenterUX/ArcCenterMenuBlade/~/hciGetStarted).
4444
- Consult your hardware OEM to verify driver compatibility. Confirm that all drivers compatible with Windows Server 2025 or Azure Stack HCI OS, 26100.xxxx are installed before the upgrade.
45+
- Make sure the Network Interface Card (NIC) driver currently installed on your system is newer than the version included by default (inbox) with Azure Stack HCI OS, version 26100.xxxx. The following table compares the current and recommended versions of NIC drivers for two vendors:
46+
| NIC vendor | Inbox driver version | Recommended Latest compatible driver |
47+
|--|--|--|
48+
| Intel | 1.15.121.0 | 1.17.73.0 |
49+
| NVIDIA | 24.4.26429.0 | 25.4.50020 |
4550
- Ensure the instance is properly registered. If the *identity* property is missing or doesn’t contain `type = "SystemAssigned"`, run the following command to repair the registration:
4651

4752
```powershell
@@ -110,11 +115,27 @@ To install the new OS using PowerShell, follow these steps:
110115

111116
1. Extract the contents of the ISO image and copy them to the local system drive on each machine. Ensure that the local path is the same on each machine. Then, update the `PathToSetupMedia` parameter with the local path to the ISO image.
112117

118+
```powershell
119+
# Define ISO and destination paths
120+
$isoFilePath = "C:\SetupFiles\WindowsServer\ISOs\example.iso"
121+
$destinationPath = "C:\SetupFiles\WindowsServer\Files"
122+
# Mount the ISO file
123+
$iso = Mount-DiskImage -ImagePath $isoFilePath
124+
# Get the drive letter
125+
$driveLetter = ($iso | Get-Volume).DriveLetter
126+
# Create the destination directory
127+
New-Item -ItemType Directory -Path $destinationPath
128+
# Copy contents to the local directory
129+
Copy-Item -Path "${driveLetter}:\*" -Destination $destinationPath –Recurse
130+
# Dismount the ISO file
131+
Dismount-DiskImage -ImagePath $isoFilePath
132+
```
133+
113134
1. Upgrade the system.
114135

115136
```powershell
116137
Invoke-CauRun –ClusterName <SystemName> -CauPluginName Microsoft.RollingUpgradePlugin -EnableFirewallRules -CauPluginArguments @{ 'WuConnected'='false';'PathToSetupMedia'='\some\path\'; 'UpdateClusterFunctionalLevel'='true'; } -ForceSelfUpdate -Force
117-
```
138+
```
118139

119140
1. Wait for the update to complete and check the status of the update.
120141

@@ -152,9 +173,33 @@ To install the new OS using PowerShell, follow these steps:
152173
```powershell
153174
Test-Cluster
154175
```
176+
1. Verify that the registry keys are still applied on each machine in the system before moving to the next step.
177+
178+
To check if the registry key exists:
179+
180+
```powershell
181+
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation"
182+
```
183+
184+
To reapply the registry keys if needed and reboot each machine for the changes to take effect:
185+
186+
```powershell
187+
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord -ErrorAction Stop
188+
```
155189

156190
You're now ready to perform the post-OS upgrade steps for your system.
157191

192+
If the OS upgrade fails, run the following command to recover the CAU run:
193+
194+
```powershell
195+
Invoke-CauRun –ForceRecovery -Force
196+
```
197+
198+
## Known issues
199+
200+
If the system is configured with Network ATC prior to performing the OS upgrade, the Network ATC management intent may fail with error `PhysicalAdapterNotFound` after upgrading the OS. For detailed steps on how to resolve this issue, see the [Troubleshooting guide](https://github.com/Azure/AzureLocal-Supportability/blob/main/TSG/Upgrade/Known%252Dissue-%252D-Network-ATC-management-intent-fails-with-%E2%80%98PhysicalAdapterNotFound%E2%80%99-after-upgrading-OS-from-22H2-to-23H2.md).
201+
202+
158203
## Next steps
159204

160205
- [Learn how to perform the post-OS upgrade steps for your Azure Local.](./post-upgrade-steps.md)

0 commit comments

Comments
 (0)