From be54f05e9c5b3ec673851a1800628eb9c674e3f6 Mon Sep 17 00:00:00 2001 From: Karl Wester-Ebbinghaus <45657752+Karl-WE@users.noreply.github.com> Date: Wed, 4 Mar 2026 01:45:57 +0100 Subject: [PATCH] Update document for Azure Stack HCI version 24H2 Clarified prerequisites and registration, converted the bullet points into a more readable table, especially because the resource registration could be overlooked. added note about download does not appear when registration is not made, in order to reduce support calls. --- azure-local/deploy/download-23h2-software.md | 70 -------------------- azure-local/deploy/download-24h2-software.md | 70 ++++++++++++++++++++ 2 files changed, 70 insertions(+), 70 deletions(-) delete mode 100644 azure-local/deploy/download-23h2-software.md create mode 100644 azure-local/deploy/download-24h2-software.md diff --git a/azure-local/deploy/download-23h2-software.md b/azure-local/deploy/download-23h2-software.md deleted file mode 100644 index efef9538b3..0000000000 --- a/azure-local/deploy/download-23h2-software.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: Download Azure Stack HCI Operating System, version 23H2 software for Azure Local deployment -description: Learn how to download Azure Local, version 23H2 software from the Azure portal to deploy an Azure Local instance. -author: alkohli -ms.author: alkohli -ms.topic: how-to -ms.service: azure-local -ms.date: 09/24/2025 -ms.subservice: hyperconverged ---- - -# Download operating system for Azure Local deployment - -[!INCLUDE [hci-applies-to-23h2](../includes/hci-applies-to-23h2.md)] - -This article describes how to download the operating system (OS) software from the Azure portal to deploy an Azure Local instance. - -The first step in deploying Azure Local is to download the OS from the Azure portal. The software download includes a free 60-day trial. However, if you've purchased Integrated System solution hardware from the [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) through your preferred Microsoft hardware partner, the OS should be preinstalled. In that case, you can skip this step and move on to [Register your machines and assign permissions for Azure Local deployment](./deployment-arc-register-server-permissions.md). - -## Prerequisites - -Before you begin the download of the software from Azure portal, ensure that you have the following prerequisites: - -- An Azure account. If you don’t already have an Azure account, first [create an account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). -- An Azure subscription. You can use an existing subscription of any type: - - - Free account with Azure credits [for students](https://azure.microsoft.com/free/students/?cid=msft_learn) or [Visual Studio subscribers](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/). - - [Pay-as-you-go](https://azure.microsoft.com/pricing/purchase-options/pay-as-you-go/) subscription with credit card. - - Subscription obtained through an Enterprise Agreement (EA). - - Subscription obtained through the Cloud Solution Provider (CSP) program. - - At a minimum, you'll need **Reader** access at the subscription level. - -- Register the Microsoft Azure Stack HCI resource provider to access the Azure Local OS image download. For instructions on registering via PowerShell or the Azure portal, see [Register required resource providers](deployment-arc-register-server-permissions.md#azure-prerequisites) in the Azure prerequisites section, or refer to [Register resource provider](/azure/azure-resource-manager/management/resource-providers-and-types#register-resource-provider). - -## Download the software from the Azure portal - -> [!IMPORTANT] -> English is the only supported language for the deployment. - -Follow these steps to download the software: - -1. If not already signed in, sign in to [Azure portal](https://ms.portal.azure.com/) with your Azure account credentials. -1. In the Azure portal search bar at the top, enter **Azure Local**. As you type, the portal starts suggesting related resources and services based on your input. Select **Azure Local** under the **Services** category. - - :::image type="content" source="media/download-23h2-software/search-software.png" alt-text="Screenshot that shows how to search for Azure Local." lightbox="media/download-23h2-software/search-software.png"::: - - After you select **Azure Local**, you're directed to the Azure Local **Get started** page, with the **Get started** tab selected by default. - -1. On the **Get started** tab, under the **Download software** tile, select **Download**. Skip this step if your Azure Local instance came installed with the OS. - - :::image type="content" source="media/download-23h2-software/get-started-page-with-download-button.png" alt-text="Screenshot of the Get started page with the option to download the Azure Stack HCI OS." lightbox="media/download-23h2-software/get-started-page-with-download-button.png"::: - -1. On the **Download Azure Stack HCI** page, do the following: - - 1. Select the subscription in which you intend to deploy Azure Local. Ensure that the selected subscription has the Microsoft Azure Stack HCI resource provider registered and which you have **Reader** access at a minimum. - - :::image type="content" source="media/download-23h2-software/download-azure-stack-hci.png" alt-text="Screenshot of the Download Azure Stack HCI OS version 23H2 page showing step 1." lightbox="media/download-23h2-software/download-azure-stack-hci.png"::: - - 2. Select your desired version. Only the recommended version is eligible for deployment using Azure portal. To deploy a previous version, use an [Azure Resource Manager template](deployment-azure-resource-manager-template.md). - - 3. Select **I agree with Azure Local license terms and privacy notice** and then select **Download**. - - :::image type="content" source="media/download-23h2-software/download-azure-stack-hci-step-2.png" alt-text="Screenshot of the Download Azure Stack HCI OS version 23H2 page showing step 2." lightbox="media/download-23h2-software/download-azure-stack-hci-step-2.png"::: - - > [!NOTE] - > This action begins the download. Use the downloaded ISO file to install the software on each machine that you want to cluster. - -## Next steps - -- [Install the Azure Stack HCI operating system](./deployment-install-os.md). diff --git a/azure-local/deploy/download-24h2-software.md b/azure-local/deploy/download-24h2-software.md new file mode 100644 index 0000000000..edd7e7cbc9 --- /dev/null +++ b/azure-local/deploy/download-24h2-software.md @@ -0,0 +1,70 @@ +--- +title: Download Azure Stack HCI Operating System, version 24H2 software for Azure Local deployment +description: Learn how to download Azure Local, version 24H2 software from the Azure portal to deploy an Azure Local instance. +author: alkohli +ms.author: alkohli +ms.topic: how-to +ms.service: azure-local +ms.date: 09/24/2025 +ms.subservice: hyperconverged +--- + +# Download operating system for Azure Local deployment + +[!INCLUDE [hci-applies-to-23h2](../includes/hci-applies-to-23h2.md)] + +This article describes how to download the operating system (OS) software from the Azure portal to deploy an Azure Local instance. + +The first step in deploying Azure Local is to download the OS from the Azure portal. The software download includes a free 60-day trial. However, if you've purchased Integrated System or Premier solution hardware from the [Azure Local Catalog](https://aka.ms/AzureStackHCICatalog) through your preferred Microsoft hardware partner (OEM), the Azure Stack HCI OS should be preinstalled. +In that case, you can skip this step and move on to [Register your machines and assign permissions for Azure Local deployment](./deployment-arc-register-server-permissions.md). + +## Prerequisites + +Before you begin the download of the software from Azure portal, ensure that you have the following prerequisites: + +| **Prerequisite** | **Instructions** | +|--------------|------------------| +| **Azure Tenant** | If you don’t already have an Azure Tenant, first create an Azure Tenant.
Ensure that you or your organization do not own an existing tenant to avoid shadow tenants, or issues with their applicable governance and licensing.

You can create an Azure Tenant by login in with your Microsoft personal or Business / School account by obtaining a free [PowerBI license](https://app.powerbi.com/home). The registered user will become the Global Administrator of this newly tenant.
If your organization already has an existing Azure tenant, please consult with your IT department, if Azure Local should be deployed in the existing tenant or adding a new tenant to comply with their applicable governance and Azure Local Licensing requirements. To learn to how add a new tenant, see [Create a new tenant](https://learn.microsoft.com//entra/fundamentals/create-new-tenant) | +| **Azure account** | An Azure account is required. first [create an account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). +| **Azure subscription** | An Azure subscription. You can use a new or existing subscription of any type:
- Free account with Azure credits [for students](https://azure.microsoft.com/free/students/?cid=msft_learn)
- [Visual Studio subscribers](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/) or
- Pay-as-you-go subscription with credit card or
- Azure Subscription obtained through an Enterprise Agreement (EA) or
- Azure Subscription obtained through the Cloud Solution Provider (CSP) program or
- other eligible Azure Subscription types containing Azure (Extended) Credits. +| **RBAC Permissions** | At a minimum, you'll need Reader access at the subscription level. Additional RBAC requirements will be specified throughout the Ressource provider registration and deployment guidance. | +| **Resource provider registration** | Before downloading, register the Microsoft Azure Stack HCI resource provider to access the Azure Local OS image download.
For instructions on registering via Azure PowerShell through the Azure portal, see [Register required resource providers for Azure Local](deployment-arc-register-server-permissions.md#azure-prerequisites) in the Azure prerequisites section.
For general information on the registration procedure of Azure resource providers, see [Register resource provider](/azure/azure-resource-manager/management/resource-providers-and-types#register-resource-provider). | + + +## Download the software from the Azure portal + +> [!IMPORTANT] +> English is the only supported language for the deployment. +> Make sure you have satisfied the permissions and resource provider registration, otherwise you may not be able to select a download of the Azure Stack HCI OS. + +Follow these steps to download the software: + +1. If not already signed in, sign in to [Azure portal](https://portal.azure.com/) with your Azure account credentials. +1. In the Azure portal search bar at the top, enter **Azure Local**. As you type, the portal starts suggesting related resources and services based on your input. Select **Azure Local** under the **Services** category. + + :::image type="content" source="media/download-23h2-software/search-software.png" alt-text="Screenshot that shows how to search for Azure Local." lightbox="media/download-23h2-software/search-software.png"::: + + After you select **Azure Local**, you're directed to the Azure Local **Get started** page, with the **Get started** tab selected by default. + +1. On the **Get started** tab, under the **Download software** tile, select **Download**. Skip this step if your Azure Local instance came installed with the OS. + + :::image type="content" source="media/download-23h2-software/get-started-page-with-download-button.png" alt-text="Screenshot of the Get started page with the option to download the Azure Stack HCI OS." lightbox="media/download-23h2-software/get-started-page-with-download-button.png"::: + +1. On the **Download Azure Stack HCI** page, do the following: + + 1. Select the subscription in which you intend to deploy Azure Local. Ensure that the selected subscription has the Microsoft Azure Stack HCI resource provider registered and which you have **Reader** access at a minimum. + + :::image type="content" source="media/download-23h2-software/download-azure-stack-hci.png" alt-text="Screenshot of the Download Azure Stack HCI OS version 23H2 page showing step 1." lightbox="media/download-23h2-software/download-azure-stack-hci.png"::: + + 2. Select your desired version. Only the recommended version is eligible for deployment using Azure portal. To deploy a previous version, use an [Azure Resource Manager template](deployment-azure-resource-manager-template.md). + + 3. Select **I agree with Azure Local license terms and privacy notice** and then select **Download**. + + :::image type="content" source="media/download-23h2-software/download-azure-stack-hci-step-2.png" alt-text="Screenshot of the Download Azure Stack HCI OS version 23H2 page showing step 2." lightbox="media/download-23h2-software/download-azure-stack-hci-step-2.png"::: + + > [!NOTE] + > This action begins the download. Use the downloaded ISO file to install the software on each machine that you want to cluster. + +## Next steps + +- [Install the Azure Stack HCI operating system](./deployment-install-os.md).