Merge pull request #15515 from ManikaDhiman/md-arc-vm-prereqs2

Court72 · web-flow · commit 2da2013d9ad6 · 2024-08-21T13:24:30.000-06:00
Changes to Arc VM prereqs--version 2
diff --git a/azure-stack/hci/manage/assign-vm-rbac-roles.md b/azure-stack/hci/manage/assign-vm-rbac-roles.md
@@ -6,7 +6,7 @@ ms.author: alkohli
 ms.topic: how-to
 ms.service: azure-stack
 ms.subservice: azure-stack-hci
-ms.date: 02/13/2024
+ms.date: 07/19/2024
 ---
 
 # Use Role-based Access Control to manage Azure Stack HCI Virtual Machines 
@@ -31,28 +31,26 @@ To control access to VMs and VM resources on your Azure Stack HCI, you can use t
 Here's a table that describes the VM actions granted by each role for the VMs and the various VM resources. The VM resources are referred to resources required to create a VM and include virtual disks, network interfaces, VM images, logical networks, and storage paths:
 
 
-|Builtin role  |VMs  |VM resources  |
-|---------|---------|---------|
-|Azure Stack HCI Administrator     |Create, list, delete VMs<br><br> Start, stop, restart VMs         |Create, list, delete all VM resources including logical networks, VM images, and storage paths         |
-|Azure Stack HCI VM Contributor     |Create, list, delete VMs<br><br> Start, stop, restart VMs         |Create, list, delete all VM resources except logical networks, VM images, and storage paths         |
-|Azure Stack HCI VM Reader    |List all VMs         |List all VM resources         |
+| Builtin role | VMs | VM resources |
+|--|--|--|
+| Azure Stack HCI Administrator | Create, list, delete VMs<br><br> Start, stop, restart VMs | Create, list, delete all VM resources including logical networks, VM images, and storage paths |
+| Azure Stack HCI VM Contributor | Create, list, delete VMs<br><br> Start, stop, restart VMs | Create, list, delete all VM resources except logical networks, VM images, and storage paths |
+| Azure Stack HCI VM Reader | List all VMs | List all VM resources |
 
  
 ## Prerequisites
 
 Before you begin, make sure to complete the following prerequisites:
 
-1. Make sure that you have access to an Azure Stack HCI cluster that is deployed and registered. During the deployment, an Arc Resource Bridge and a custom location are also created.
-    
-    Go to the resource group in Azure. You can see the custom location and Azure Arc Resource Bridge created for the Azure Stack HCI cluster. Make a note of the subscription, resource group, and the custom location as you use these later in this scenario.
+1. Make sure that complete the [Azure Stack HCI cluster requirements](./azure-arc-vm-management-prerequisites.md).
 
 1. Make sure that you have access to Azure subscription as an Owner or User Access Administrator to assign roles to others.
 
 ## Assign RBAC roles to users
 
 You can assign RBAC roles to user via the Azure portal. Follow these steps to assign RBAC roles to users:
 
-1. In the Azure Portal, search for the scope to grant access to, for example, search for subscriptions, resource groups, or a specific resource. In this example, we use the subscription in which the Azure Stack HCI cluster is deployed.
+1. In the Azure portal, search for the scope to grant access to, for example, search for subscriptions, resource groups, or a specific resource. In this example, we use the subscription in which the Azure Stack HCI cluster is deployed.
 
 
 1. Go to your subscription and then go to **Access control (IAM) > Role assignments**. From the top command bar, select **+ Add** and then select **Add role assignment**.
diff --git a/azure-stack/hci/manage/azure-arc-vm-management-prerequisites.md b/azure-stack/hci/manage/azure-arc-vm-management-prerequisites.md
@@ -6,7 +6,7 @@ ms.author: alkohli
 ms.topic: how-to
 ms.service: azure-stack
 ms.subservice: azure-stack-hci
-ms.date: 02/28/2024
+ms.date: 07/18/2024
 ---
 
 # Azure Arc VM management prerequisites
@@ -19,15 +19,24 @@ This article lists the requirements and prerequisites for Azure Arc VM managemen
 
 The Azure requirements include:
 
-- To provision Arc VMs and VM resources such as virtual disks, logical network, network interfaces and VM images through the Azure portal, you  must have **Contributor** level access at the subscription level.
+- To provision Arc VMs and VM resources such as virtual disks, logical network, network interfaces, and VM images through the Azure portal, you must have access to an Azure subscription with the appropriate RBAC role and permissions assigned. For more information, see [RBAC roles for Azure Stack HCI Arc VM management](./assign-vm-rbac-roles.md#about-builtin-rbac-roles).
 
 - Arc VM management infrastructure is supported in the regions documented in the [Azure requirements](../concepts//system-requirements-23h2.md#azure-requirements). For Arc VM management on Azure Stack HCI, all entities must be registered, enabled, or created in the same region.
 
-    The entities include Azure Stack HCI cluster, Arc Resource Bridge, Custom Location, VM operator, virtual machines created from Arc and Azure Arc for Servers guest management. These entities can be in different or same resource groups as long as all resource groups are in the same region.
+  The entities include Azure Stack HCI cluster, Arc Resource Bridge, Custom Location, VM operator, virtual machines created from Arc and Azure Arc for Servers guest management. These entities can be in different or same resource groups as long as all resource groups are in the same region.
 
+## Azure Stack HCI cluster requirements
+
+- You have access to an Azure Stack HCI system that is deployed, has an Arc Resource Bridge and a custom location.
+
+  - Go to the **Overview > Server** page in the Azure Stack HCI system resource. Verify that **Azure Arc** shows as **Connected**. You should also see a custom location and an Arc Resource Bridge for your cluster.
+    
+       :::image type="content" source="./media/azure-arc-vm-management-prerequisites/azure-arc-connected.png" alt-text="Screenshot of the Overview page in the Azure Stack HCI cluster resource showing Azure Arc as connected." lightbox="./media/azure-arc-vm-management-prerequisites/azure-arc-connected.png":::
 
 ## Azure Command-Line Interface (CLI) requirements
 
+Skip this section if not using Azure CLI to provision and manage Arc VMs and VM resources.
+
 You can connect to Azure Stack HCI system directly or you can access the cluster remotely. Depending on whether you're connecting to the cluster directly or remotely, the steps are different.
 
 For information on Azure CLI commands for Azure Stack HCI VMs, see [az stack-hci-vm](/cli/azure/stack-hci-vm).
@@ -38,7 +47,6 @@ If you're accessing the Azure Stack HCI cluster directly, no steps are needed on
 
 During the cluster deployment, an Arc Resource Bridge is created and the Azure CLI extension `stack-hci-vm` is installed on the cluster. You can connect to and manage the cluster using the Azure CLI extension.
 
-
 ### Connect to the cluster remotely
 
 If you're accessing the Azure Stack HCI system remotely, the following requirements must be met:
@@ -51,7 +59,7 @@ If you're accessing the Azure Stack HCI system remotely, the following requireme
 
     - Run [az version](/cli/azure/reference-index?#az-version) to find the version and dependent libraries that are installed. To upgrade to the latest version, run [az upgrade](/cli/azure/reference-index?#az-upgrade).
 
-- The Azure Stack HCI extension `stack-hci-vm`. Run PowerShell as an administrator on your client and run the following command :
+- The Azure Stack HCI extension `stack-hci-vm`. Run PowerShell as an administrator on your client and run the following command:
 
   ```PowerShell
   az extension add --name "stack-hci-vm"
diff --git a/azure-stack/hci/manage/create-logical-networks.md b/azure-stack/hci/manage/create-logical-networks.md
@@ -6,7 +6,7 @@ ms.author: alkohli
 ms.topic: how-to
 ms.service: azure-stack
 ms.subservice: azure-stack-hci
-ms.date: 01/03/2024
+ms.date: 07/18/2024
 ---
 
 # Create logical networks for Azure Stack HCI
@@ -20,7 +20,10 @@ This article describes how to create or add logical networks for your Azure Stac
 
 Before you begin, make sure to complete the following prerequisites:
 
-[!INCLUDE [hci-vm-image-prerequisites-marketplace](../../includes/hci-vm-image-prerequisites-marketplace.md)]
+
+# [Azure CLI](#tab/azurecli)
+
+- Make sure to review and [complete the prerequisites](./azure-arc-vm-management-prerequisites.md). If using a client to connect to your Azure Stack HCI cluster, see [Connect to the cluster remotely](./azure-arc-vm-management-prerequisites.md#connect-to-the-cluster-remotely).
 
 - Make sure you have an external VM switch that can be accessed by all the servers in your Azure Stack HCI cluster. By default, an external switch is created during the deployment of your Azure Stack HCI cluster that you can use to associate with the logical network you will create.
 
@@ -42,6 +45,12 @@ Before you begin, make sure to complete the following prerequisites:
 
 - To create VMs with static IP addresses in your address space, add a logical network with static IP allocation. Reserve an IP range with your network admin and make sure to get the address prefix for this IP range.
 
+# [Azure portal](#tab/azureportal)
+
+The prerequisites for the Azure portal are the same as those for the Azure CLI. See [Azure CLI](./create-logical-networks.md?tabs=azurecli#tabpanel_1_azurecli).
+
+---
+
 ## Create the logical network
 
 You can create a logical network using either the Azure Command-Line Interface (CLI) or by using the Azure portal.
diff --git a/azure-stack/hci/manage/create-network-interfaces.md b/azure-stack/hci/manage/create-network-interfaces.md
@@ -8,7 +8,7 @@ ms.topic: how-to
 ms.service: azure-stack
 ms.subservice: azure-stack-hci
 ms.custom: devx-track-azurecli
-ms.date: 11/20/2023
+ms.date: 07/17/2024
 ---
 
 # Create network interfaces for Arc virtual machines on Azure Stack HCI
@@ -31,20 +31,16 @@ Before you create a network interface, make sure that the following prerequisite
 
 # [Azure CLI](#tab/azurecli)
 
-[!INCLUDE [hci-vm-prerequisites](../../includes/hci-vm-prerequisites.md)]
-
-- If using a client to connect to your Azure Stack HCI cluster, see [Connect to Azure Stack HCI via Azure CLI client](./azure-arc-vm-management-prerequisites.md#azure-command-line-interface-cli-requirements).
+- Make sure to review and [complete the prerequisites](./azure-arc-vm-management-prerequisites.md). If using a client to connect to your Azure Stack HCI cluster, see [Connect to the cluster remotely](./azure-arc-vm-management-prerequisites.md#connect-to-the-cluster-remotely).
 
 - Access to a logical network that you created on your Azure Stack HCI cluster. For more information, see [Create logical network](./create-virtual-networks.md).
 
-
 # [Azure portal](#tab/azureportal)
 
-[!INCLUDE [hci-vm-prerequisites](../../includes/hci-vm-prerequisites.md)]
+In the Azure portal, you create a network interface during the VM creation flow. For prerequisites and more information, see [Create Azure Stack HCI VM in Azure portal](./create-arc-virtual-machines.md).
 
 ---
 
-
 ## Create network interface
 
 To create a VM, you'll first need to create a network interface on your logical network. The steps can be different depending on whether your logical network is static or DHCP.
diff --git a/azure-stack/hci/manage/create-storage-path.md b/azure-stack/hci/manage/create-storage-path.md
@@ -6,7 +6,7 @@ ms.author: alkohli
 ms.topic: how-to
 ms.service: azure-stack
 ms.subservice: azure-stack-hci
-ms.date: 07/10/2024
+ms.date: 07/19/2024
 ---
 
 # Create storage path for Azure Stack HCI 
@@ -28,13 +28,10 @@ The available space in the cluster shared volume determines the size of the stor
 
 Before you begin, make sure to complete the following prerequisites:
 
-1. Make sure that you have access to an Azure Stack HCI cluster that is deployed and registered. During the deployment, an Arc Resource Bridge and a custom location are also created. 
-    
-    Go to the resource group in Azure. You can see the custom location and Azure Arc Resource Bridge created for the Azure Stack HCI cluster. Make a note of the subscription, resource group, and the custom location as you use these later in this scenario.
+1. Make sure that complete the [Azure Stack HCI cluster requirements](./azure-arc-vm-management-prerequisites.md).
 
 1. Make sure that a cluster shared volume exists on your Azure Stack HCI cluster that is accessible from all the servers in the cluster. The storage path that you intend to provide on a cluster shared volume should have sufficient space for storing VM images. By default, cluster shared volumes are created during the deployment of Azure Stack HCI cluster. 
 
-
     You can create storage paths only within cluster shared volumes that are available in the cluster. For more information, see [Create a cluster shared volume](/windows-server/failover-clustering/failover-cluster-csvs#add-a-disk-to-csv-on-a-failover-cluster).
 
 
diff --git a/azure-stack/hci/manage/media/azure-arc-vm-management-prerequisites/azure-arc-connected.png b/azure-stack/hci/manage/media/azure-arc-vm-management-prerequisites/azure-arc-connected.png
diff --git a/azure-stack/hci/manage/virtual-machine-image-azure-marketplace.md b/azure-stack/hci/manage/virtual-machine-image-azure-marketplace.md
@@ -8,7 +8,7 @@ ms.service: azure-stack
 ms.subservice: azure-stack-hci
 ms.custom:
   - devx-track-azurecli
-ms.date: 02/29/2024
+ms.date: 07/18/2024
 ---
 
 # Create Azure Stack HCI VM image using Azure Marketplace images
@@ -24,13 +24,13 @@ Before you begin, make sure that the following prerequisites are completed.
 
 # [Azure CLI](#tab/azurecli)
 
-[!INCLUDE [hci-vm-image-prerequisites-marketplace](../../includes/hci-vm-image-prerequisites-marketplace.md)]
+- Make sure to review and [complete the prerequisites](./azure-arc-vm-management-prerequisites.md).
 
-- If using a client to connect to your Azure Stack HCI cluster, see [Connect to Azure Stack HCI via Azure CLI client](./azure-arc-vm-management-prerequisites.md#azure-command-line-interface-cli-requirements).
+- If using a client to connect to your Azure Stack HCI cluster, see [Connect to the cluster remotely](./azure-arc-vm-management-prerequisites.md#connect-to-the-cluster-remotely).
 
 # [Azure portal](#tab/azureportal)
 
-[!INCLUDE [hci-vm-image-prerequisites-marketplace](../../includes/hci-vm-image-prerequisites-marketplace.md)]
+Make sure to review and [complete the prerequisites](./azure-arc-vm-management-prerequisites.md).
 
 ---
 
diff --git a/azure-stack/includes/hci-vm-image-prerequisites-local-share.md b/azure-stack/includes/hci-vm-image-prerequisites-local-share.md
@@ -4,17 +4,11 @@ ms.author: alkohli
 ms.service: azure-stack
 ms.subservice: azure-stack-hci
 ms.topic: include
-ms.date: 02/29/2024
+ms.date: 07/18/2024
 ---
 
 
-- Make sure to review and [Complete the prerequisites](../hci/manage/azure-arc-vm-management-prerequisites.md).
-
-- You have access to an Azure Stack HCI system that is deployed, has an Arc Resource Bridge and a custom location.
-
-   - Go to the **Overview > Server** page in the Azure Stack HCI system resource. Verify that **Azure Arc** shows as **Connected**. You should also see a custom location and an Arc Resource Bridge for your cluster.
-    
-    :::image type="content" source="./media/hci-vm-image-prerequisites-local-share/azure-arc-connected.png" alt-text="Screenshot of the Overview page in the Azure Stack HCI cluster resource showing Azure Arc as connected." lightbox="./media/hci-vm-image-prerequisites-local-share/azure-arc-connected.png":::
+- Make sure to review and [complete the prerequisites](../hci/manage/azure-arc-vm-management-prerequisites.md).
 
 - For custom images in a local share on your Azure Stack HCI, you'll have the following extra prerequisites:
     - You should have a VHD/VHDX uploaded to a local share on your Azure Stack HCI cluster.
diff --git a/azure-stack/includes/hci-vm-image-prerequisites-marketplace.md b/azure-stack/includes/hci-vm-image-prerequisites-marketplace.md
diff --git a/azure-stack/includes/hci-vm-image-prerequisites-storage-account.md b/azure-stack/includes/hci-vm-image-prerequisites-storage-account.md
@@ -4,17 +4,12 @@ ms.author: alkohli
 ms.service: azure-stack
 ms.subservice: azure-stack-hci
 ms.topic: include
-ms.date: 02/02/2024
+ms.date: 07/18/2024
 ---
 
 
-- Make sure to review and [Complete the prerequisites](../hci/manage/azure-arc-vm-management-prerequisites.md).
+- Make sure to review and [complete the prerequisites](../hci/manage/azure-arc-vm-management-prerequisites.md).
 
-- You have access to an Azure Stack HCI system that is deployed, has an Arc Resource Bridge and a custom location.
-
-   - Go to the **Overview > Server** page in the Azure Stack HCI system resource. Verify that **Azure Arc** shows as **Connected**. You should also see a custom location and an Arc Resource Bridge for your cluster.
-    
-    :::image type="content" source="./media/hci-vm-image-prerequisites-storage-account/azure-arc-connected.png" alt-text="Screenshot of the Overview page in the Azure Stack HCI cluster resource showing Azure Arc as connected." lightbox="../hci/manage/media/virtual-machine-image-storage-account/azure-arc-connected.png":::
 
 - For custom images in Azure Storage account, you have the following extra prerequisites:
 
