More changes

Author: alkohli

azure-stack/hci/upgrade/install-solution-upgrade.md

@@ -24,47 +24,67 @@ Before you install the solution upgrade, make sure that you:
 
 - Validate the cluster using the Environment Checker as per the instructions  in [Assess solution upgrade readiness](./validate-solution-upgrade-readiness.md#run-the-validation).
 - Verify that latest `AzureEdgeLifecycleManager` extension on each cluster node is installed as per the instructions in [Check the Azure Arc extension](./validate-solution-upgrade-readiness.md#remediation-9-check-the-azure-arc-lifecycle-extension).
+
+    :::image type="content" source="media/install-solution-upgrade/verify-lcmextension-installed.png" alt-text="Screenshot of Extensions page showing AzureEdgeLifeCycleManager extension install on Azure Stack HCI node" lightbox="./media/install-solution-upgrade/verify-lcmextension-installed.png":::
+
 - Have an Active Directory user credential that's a member of the local Administrator group. Work with your Active Directory administrator to obtain this credential.
 - Have IPv4 network range with six, contiguous IP addresses available for new Azure Arc services. Work with your network administrator to ensure that the IP addresses aren't in use and meet the outbound connectivity requirement.
 - Have Azure subscription permissions for [Azure Stack HCI Administrator and Reader](../manage/assign-vm-rbac-roles.md#about-builtin-rbac-roles).  
 
+    :::image type="content" source="media/install-solution-upgrade/verify-subscription-permissions-roles.png" alt-text="Screenshot of Extensions page showing AzureEdgeLifeCycleManager extension install on Azure Stack HCI node" lightbox="./media/install-solution-upgrade/verify-subscription-permissions-roles.png":::
+
+
 ## Install the solution upgrade via Azure portal
 
+You install the solution upgrade via the Azure portal.
+
+1. Go to your Azure Stack HCI cluster resource in the portal.
+1. In the **Overview** page, you can see a banner indicating that a solution upgrade is available. Select the **Upgrade** link in the banner.
+
+   :::image type="content" source="./media/install-solution-upgrade/upgrade-banner.png" alt-text="Screenshot of Azure Stack HCI Overview page with upgrade available banner." lightbox="./media/install-solution-upgrade/upgrade-banner.png":::
+
+
 ### Basics tab
 
 On the **Basics** tab, specify the following information:
 
-1. Specify whether you want to create a new key vault to store the credentials, or if you want to select an existing key vault. Only vaults in the same resource group are shown.
+1. Select an existing key vault from vaults in the resource group. Sharing an existing key vault can have security implications. If you don't have a key vault, you can create a new one to store the credentials.
 
-   > [!NOTE]
-   > We recommend that you select a new key vault as sharing an existing key vauilt may have security implications.
+   1. Select **Create a new key vault**.
+   1. Provide a **Name** for the new key vault. The name should be 3 to 24 characters long and contain only letters, numbers, and hyphens. Two consecutive hyphens are not allowed.
+
+   :::image type="content" source="./media/install-solution-upgrade/create-new-key-vault.png" alt-text="Screenshot of **Create key vault** page." lightbox="./media/install-solution-upgrade/create-new-key-vault.png":::
 
 1. Specify the deployment account credential. This credential is from your Active Directory for a principal that is a member of the local Administrator group on each cluster node.
 
    > [!NOTE]
    > The user can't be Administrator and can't use format `domain\username`.
 
-1. Specify the custom location name used for Azure Arc services.
+1. Accept default name or specify the custom location name used for Azure Arc services.
 
-1. Specify network IP address information. A total of six IP addresses is required, defined by an IP address range. IP addresses in the range must:
+1. Specify network IP address information. A total of six, conntiguous IP addresses is required, defined by an IP address range. IP addresses in the range must:
 
    - Not be in use.
    - Meet outbound connectivity requirements.
    - Communicate to the host IP addresses.
 
    :::image type="content" source="./media/install-solution-upgrade/upgrade-22h2-to-23h2-basics-tab.png" alt-text="Screenshot of Upgrade Azure Stack HCI basics tab." lightbox="./media/install-solution-upgrade/upgrade-22h2-to-23h2-basics-tab.png":::
 
+1. Select **Next: Validation**.
+
 ### Validation tab
 
 On the **Validation** tab, the operation automatically creates Azure resources like the cluster and the service principal, and also configures permissions and the audit login.
 
-1. Select **Start validation** to begin the operation. To learn more about validation, see [Validate solution upgrade readiness of your Azure Stack HCI cluster](./validate-solution-upgrade-readiness.md).
+1. Select **Start validation** to begin the operation. This operation involves running the Environment Checker to check external connectivity and storage requirements and that the environment is ready for solution upgrade. To learn more about validation, see [Validate solution upgrade readiness of your Azure Stack HCI cluster](./validate-solution-upgrade-readiness.md).
 
    :::image type="content" source="./media/install-solution-upgrade/upgrade-22h2-to-23h2-validation-tab.png" alt-text="Screenshot of Upgrade Azure Stack HCI validation tab." lightbox="./media/install-solution-upgrade/upgrade-22h2-to-23h2-validation-tab.png":::
 
+1. After the validation is complete, select **Next: Review + Create**.
+
 ### Review + Create tab
 
-Review the summary for the solution upgrade and then select **Review + Create**.
+On the **Review + Create** tab, review the summary for the solution upgrade.
 
 :::image type="content" source="./media/install-solution-upgrade/upgrade-22h2-to-23h2-review-and-create-tab.png" alt-text="Screenshot of Upgrade Azure Stack HCI review and create tab." lightbox="./media/install-solution-upgrade/upgrade-22h2-to-23h2-review-and-create-tab.png":::
 
@@ -76,3 +96,23 @@ To monitor upgrade progress, select **Settings** > **Deployments**.
 
 > [!NOTE]
 > If the upgrade fails, restart the upgrade operation to try again.
+
+## Verify a successful upgrade
+
+Follow these steps to verify that the upgrade was successful:
+
+1. In the Azure portal, go to the resource group where you deployed the Azure Stack HCI system.
+1. On the **Overview > Resources** page, you should see the following resources:
+
+    
+    | Resource type | Number of resources   |
+    |---------|---------|
+    | Machine - Azure Arc     | 1 per server         |
+    | Azure Stack HCI         | 1       |
+    | Arc Resource Bridge     | 1, *-arcbridge* suffix by default       |
+    | Custom location         | 1, *-cl* suffix by default       |
+    | Key Vault               | 1       |
+
+    Here is a screenshot of the resources in the resource group:
+
+    :::image type="content" source="./media/install-solution-upgrade/verify-upgrade-portal.png" alt-text="Screenshot of Upgrade Azure Stack HCI resource health." lightbox="./media/install-solution-upgrade/verify-upgrade-portal.png":::