Merge pull request #17936 from ManikaDhiman/md-uuf-359323-upgrade-wac

JillGrant615 · web-flow · commit 8755fc2e0623 · 2025-05-15T10:01:04.000-06:00
UUFs 359323, 302143, and 374662: Revisions to the upgrade articles and TOC
diff --git a/azure-local/TOC.yml b/azure-local/TOC.yml
@@ -184,21 +184,21 @@ items:
   items:
   - name: About Azure Local upgrades
     href: upgrade/about-upgrades-23h2.md
-  - name: 1 - Upgrade to version 23H2 OS
+  - name: 1. Upgrade to version 23H2 OS
     items: 
-    - name: 1A - Via PowerShell
+    - name: Via PowerShell (recommended)
       href: upgrade/upgrade-22h2-to-23h2-powershell.md
-    - name: 1B - Via Windows Admin Center
+    - name: Via Windows Admin Center
       href: upgrade/upgrade-22h2-to-23h2-windows-admin-center.md
-    - name: 1C - Via other methods
+    - name: Via other methods
       href: upgrade/upgrade-22h2-to-23h2-other-methods.md
-  - name: 2 - Perform post-OS upgrade tasks
+  - name: 2. Perform post-OS upgrade tasks
     href: upgrade/post-upgrade-steps.md
-  - name: 3 - Install, enable Network ATC
+  - name: 3. Install, enable Network ATC
     href: upgrade/install-enable-network-atc.md
-  - name: 4 - Validate solution upgrade readiness
+  - name: 4. Validate solution upgrade readiness
     href: upgrade/validate-solution-upgrade-readiness.md
-  - name: 5 - Apply solution upgrade
+  - name: 5. Apply solution upgrade
     href: upgrade/install-solution-upgrade.md
   - name: Troubleshoot upgrades
     href: upgrade/troubleshoot-upgrade-to-23h2.md
diff --git a/azure-local/upgrade/install-solution-upgrade.md b/azure-local/upgrade/install-solution-upgrade.md
@@ -3,7 +3,7 @@ title: Install solution upgrade on Azure Local
 description: Learn how to install the solution upgrade on your Azure Local instance.
 author: alkohli
 ms.topic: how-to
-ms.date: 04/16/2025
+ms.date: 05/13/2025
 ms.author: alkohli
 ms.reviewer: alkohli
 ms.service: azure-local
@@ -38,15 +38,19 @@ Before you install the solution upgrade, make sure that you:
 
     :::image type="content" source="media/install-solution-upgrade/verify-subscription-permissions-roles.png" alt-text="Screenshot of subscription with permissions assigned to required roles for upgrade." lightbox="./media/install-solution-upgrade/verify-subscription-permissions-roles.png":::
 
+## Before you begin
+
+There are a few things to consider before you begin the solution upgrade process:
+
+- Microsoft only supports upgrade applied from Azure Local resource page. Use of third party tools to install upgrades isn't supported.
+- We recommend you perform the solution upgrade during a maintenance window. After the upgrade, host machine might reboot and the workloads will be live migrated, causing brief disconnections.
+- If you have Azure Kubernetes Service (AKS) workloads on Azure Local, wait for the solution upgrade banner to appear on the Azure Local resource page. Then, remove AKS and all AKS hybrid settings before you apply the solution upgrade.
+- By installing the solution upgrade, existing Hyper-V VMs won't automatically become Azure Arc VMs.
+
 ## Install the solution upgrade via Azure portal
 
 You install the solution upgrade via the Azure portal.
 
-> [!IMPORTANT]
-> - Microsoft only supports upgrade applied from Azure Local resource page. Use of 3rd party tools to install upgrades is not supported.
-> - If you have Azure Kubernetes Service (AKS) workloads on Azure Local, wait for the solution upgrade banner to appear on the Azure Local resource page. Then, remove AKS and all AKS hybrid settings before you apply the solution upgrade.
-> - By installing the solution upgrade, existing Hyper-V VMs won't automatically become Azure Arc VMs.
-
 Follow these steps to install the solution upgrade:
 
 1. Go to your Azure Local resource in Azure portal.
diff --git a/azure-local/upgrade/upgrade-22h2-to-23h2-other-methods.md b/azure-local/upgrade/upgrade-22h2-to-23h2-other-methods.md
@@ -15,7 +15,7 @@ ms.service: azure-local
 
 [!INCLUDE [end-of-service-22H2](../includes/end-of-service-22h2.md)]
 
-This article describes how to upgrade the operating system (OS) for Azure Local from version 22H2 to version 23H2 using manual methods, such as [SConfig](/windows-server/administration/server-core/server-core-sconfig) and performing an offline upgrade.
+This article describes how to upgrade the operating system (OS) for Azure Local from version 22H2 to version 23H2 using manual methods, such as [SConfig](/windows-server/administration/server-core/server-core-sconfig) and performing an offline upgrade. This is the first step in the upgrade process, which upgrades only the OS.
 
 While you can use these other methods, PowerShell is the recommended method to upgrade the OS. For more information, see [Upgrade the Azure Stack HCI OS, version 22H2 to version 23H2 via PowerShell](./upgrade-22h2-to-23h2-powershell.md).
 
diff --git a/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md b/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md
@@ -15,7 +15,7 @@ ms.service: azure-local
 
 [!INCLUDE [end-of-service-22H2](../includes/end-of-service-22h2.md)]
 
-This article describes how to upgrade the operating system (OS) for Azure Local from version 22H2 to version 23H2 via PowerShell. Upgrade using PowerShell is the recommended method to upgrade the OS.
+This article describes how to upgrade the operating system (OS) for Azure Local from version 22H2 to version 23H2 via PowerShell, which is the recommended method to upgrade the OS. This is the first step in the upgrade process, which upgrades only the OS.
 
 There are other methods to upgrade the OS that include using Windows Admin Center and the Server Configuration tool (SConfig). For more information about these methods, see [Upgrade the Azure Stack HCI OS, version 22H2 OS via Windows Admin Center](./upgrade-22h2-to-23h2-windows-admin-center.md) and [Upgrade Azure Local to new OS using other methods](./upgrade-22h2-to-23h2-other-methods.md).
 
diff --git a/azure-local/upgrade/upgrade-22h2-to-23h2-windows-admin-center.md b/azure-local/upgrade/upgrade-22h2-to-23h2-windows-admin-center.md
@@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via Windows Admi
 description: Learn how to upgrade Azure Stack HCI OS, version 22H2 to version 23H2 using Windows Admin Center.
 author: alkohli
 ms.topic: how-to
-ms.date: 05/12/2025
+ms.date: 05/13/2025
 ms.author: alkohli
 ms.reviewer: alkohli
 ms.service: azure-local
@@ -15,7 +15,7 @@ ms.service: azure-local
 
 [!INCLUDE [end-of-service-22H2](../includes/end-of-service-22h2.md)]
 
-This article describes how to upgrade the operating system (OS) for Azure Local from version 22H2 to version 23H2 via the Windows Admin Center.
+This article describes how to upgrade the operating system (OS) for Azure Local from version 22H2 to version 23H2 via the Windows Admin Center. This is the first step in the upgrade process, which upgrades only the OS.
 
 While the recommended method is to [Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via PowerShell](./upgrade-22h2-to-23h2-powershell.md), you can also upgrade via Windows Admin Center or other methods.
 
diff --git a/azure-local/upgrade/validate-solution-upgrade-readiness.md b/azure-local/upgrade/validate-solution-upgrade-readiness.md
@@ -3,7 +3,7 @@ title: Validate solution upgrade readiness for Azure Local, version 23H2
 description: Learn how to assess upgrade readiness for Azure Local, version 23H2 that already had its operating system upgraded from version 22H2.
 author: alkohli
 ms.topic: how-to
-ms.date: 04/17/2025
+ms.date: 05/13/2025
 ms.author: alkohli
 ms.reviewer: alkohli
 ms.service: azure-local
@@ -95,7 +95,7 @@ Follow these steps to set up the Environment Checker on a machine of your Azure
    Invoke-AzStackHciUpgradeValidation
    ```
 
-1. To validate other machines in the system, run the following PowerShell command:
+1. To remotely validate other machines in the system, run the following PowerShell command for each remote machine:
 
    ```powershell
    $PsSession=New-Pssession -ComputerName "MyRemoteMachine"
