Edit

Azure Arc VM management prerequisites

  • Article

Applies to: Azure Stack HCI, version 23H2

This article lists the requirements and prerequisites for Azure Arc VM management. We recommend that you review the requirements and complete the prerequisites before you manage your Arc VMs.

Azure requirements

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.

  • Arc VM management infrastructure is supported in the regions documented in the 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.

Azure Command-Line Interface (CLI) requirements

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.

Connect to the cluster directly

If you're accessing the Azure Stack HCI cluster directly, no steps are needed on your part.

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:

  • The latest version of Azure Command-Line Interface (CLI). You must install this version on the client that you're using to connect to your Azure Stack HCI cluster.

    • For installation instructions, see Install Azure CLI. Once you have installed az CLI, make sure to restart the system.

      • If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see Sign in with the Azure CLI.

      • Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.

  • The Azure Stack HCI extension stack-hci-vm. Run PowerShell as an administrator on your client and run the following command :

    az extension add --name "stack-hci-vm"

Next steps