| title | description | author | ms.author | ms.topic | ms.service | ms.subservice | ms.custom | ms.date |
|---|---|---|---|---|---|---|---|---|
Azure Hybrid Benefit for Azure Stack HCI |
Learn about Azure Hybrid Benefit for Azure Stack HCI. |
sethmanheim |
sethm |
conceptual |
azure-stack |
azure-stack-hci |
devx-track-azurepowershell |
04/29/2024 |
[!INCLUDE applies-to]
This article describes Azure Hybrid Benefit and how to use it for Azure Stack HCI.
Azure Hybrid Benefit is a program that helps you reduce the costs of running workloads in the cloud. With Azure Hybrid Benefit for Azure Stack HCI, you can maximize the value of your on-premises licenses and modernize your existing infrastructure to Azure Stack HCI at no additional cost.
If you have Windows Server Datacenter licenses with active Software Assurance, you are eligible to activate Azure Hybrid Benefit for your Azure Stack HCI cluster. To activate this benefit, you'll need to exchange 1-core license of Software Assurance-enabled Windows Server Datacenter for 1-physical core of Azure Stack HCI. For detailed licensing requirements, see Azure Hybrid Benefit for Windows Server.
This benefit waives the Azure Stack HCI host service fee and Windows Server guest subscription on your cluster. Other costs associated with Azure Stack HCI, such as Azure services, are billed as per normal. For details about pricing with Azure Hybrid Benefit, see Azure Stack HCI pricing.
Tip
You can maximize cost savings by also using Azure Hybrid Benefit for AKS. For more information, see Azure Hybrid Benefits for AKS.
You can activate Azure Hybrid Benefit for your Azure Stack HCI cluster using the Azure portal.
The following prerequisites are required to activate Azure Hybrid Benefit for your Azure Stack HCI cluster:
-
Make sure your Azure Stack HCI cluster is installed with the following:
- Version 22H2 or later; or
- Version 21H2 with at least the September 13, 2022 security update KB5017316 or later
-
Make sure that all servers in your cluster are online and registered with Azure
-
Make sure that your cluster has Windows Server Datacenter licenses with active Software Assurance. For other licensing prerequisites, see Licensing prerequisites
-
Make sure you have permission to write to the Azure Stack HCI resource. This is included if you're assigned the contributor or owner role on your subscription
Follow these steps to activate Azure Hybrid Benefit for your Azure Stack HCI cluster via the Azure portal:
-
Use your Microsoft Azure credentials to sign in to the Azure portal at this URL: https://portal.azure.com.
-
Go to your Azure Stack HCI cluster resource page.
-
Under Settings, select Configuration.
-
Under Azure Hybrid Benefit, select the Activate link.
-
In the Activate Azure Hybrid Benefit pane on the right-hand side, confirm the designated cluster and the number of core licenses you wish to allocate, and select Activate again to confirm.
[!NOTE] You can't deactivate Azure Hybrid Benefit for your cluster after activation. Proceed after you have confirmed the changes.
:::image type="content" source="media/azure-hybrid-benefit-hci/activate-azure-hybrid-benefit.png" alt-text="Screenshot showing how to activate Azure Hybrid Benefit." lightbox="media/azure-hybrid-benefit-hci/activate-azure-hybrid-benefit.png":::
-
When Azure Hybrid Benefit successfully activates for your cluster, the Azure Stack HCI host fee is waived for the cluster.
[!IMPORTANT] Windows Server subscription is a way to get unlimited virtualization rights on your cluster through Azure. Now that you have Azure Hybrid Benefit enabled, you have the option of turning on Windows Server subscription at no additional cost.
-
To enable Windows Server subscription at no additional cost, under the Windows Server subscription add-on feature in the same Configuration pane, select Activate benefit.
-
In the Activate Azure Hybrid Benefit pane on the right-hand side, check the details and then select Activate to confirm. Upon activation, licenses take a few minutes to apply and set up automatic VM activation (AVMA) on the cluster.
:::image type="content" source="media/azure-hybrid-benefit-hci/activate-windows-server-subscription.png" alt-text="Screenshot showing how to activate Windows Server subscription." lightbox="media/azure-hybrid-benefit-hci/activate-windows-server-subscription.png":::
Azure PowerShell can be run in Azure Cloud Shell. This document details how to use PowerShell in Azure Cloud Shell. For more information, see Quickstart for Azure Cloud Shell.
Launch Azure Cloud Shell and use Azure PowerShell to perform the following steps:
-
Set up parameters from your subscription, resource group, and cluster name
$subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID $resourceGroup = "hcicluster-rg" # Replace with your resource group name $clusterName = "HCICluster" # Replace with your cluster name Set-AzContext -Subscription "${subscription}"
-
To view Azure Hybrid Benefits status on a cluster, run the following command:
Install-Module -Name Az.ResourceGraph Search-AzGraph -Query "resources | where type == 'microsoft.azurestackhci/clusters'| where name == '${clusterName}' | project id, properties['softwareAssuranceProperties']['softwareAssuranceStatus']"
-
To enable Azure Hybrid Benefits, run the following command and check if Azure Hybrid Benefits got enabled using above command:
Invoke-AzStackHciExtendClusterSoftwareAssuranceBenefit -ClusterName "${clusterName}" -ResourceGroupName "${resourceGroup}" -SoftwareAssuranceIntent "Enable"
Azure CLI is available to install in Windows, macOS and Linux environments. It can also be run in Azure Cloud Shell. This document details how to use Bash in Azure Cloud Shell. For more information, refer Quickstart for Azure Cloud Shell.
Launch Azure Cloud Shell and use Azure CLI to configure Azure Hybrid Benefits following these steps:
-
Set up parameters from your subscription, resource group, and cluster name
subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID resourceGroup="hcicluster-rg" # Replace with your resource group name clusterName="HCICluster" # Replace with your cluster name az account set --subscription "${subscription}" -
To view Azure Hybrid Benefits status on a cluster, run the following command:
az stack-hci cluster list \ --resource-group "${resourceGroup}" \ --query "[?name=='${clusterName}'].{Name:name, SoftwareAssurance:softwareAssuranceProperties.softwareAssuranceStatus}" \ -o table -
To enable Azure Hybrid Benefits, run the following command:
az stack-hci cluster extend-software-assurance-benefit \ --cluster-name "${clusterName}" \ --resource-group "${resourceGroup}" \ --software-assurance-intent enable
After you activate your Azure Stack HCI cluster with Azure Hybrid Benefit, you must regularly check status and maintain compliance for Azure Hybrid Benefit. An Azure Stack HCI cluster using Azure Hybrid Benefit can run only during the Software Assurance term. When the Software Assurance term is nearing expiry, you need to either renew your agreement with Software Assurance, disable the Azure Hybrid Benefit functionality, or de-provision the clusters that are using Azure Hybrid Benefit.
You can perform an inventory of your clusters through the Azure portal and Azure Resource Graph as described in the following section.
You can verify if your cluster is using Azure Hybrid Benefit via Azure portal, PowerShell, or Azure CLI.
- In your Azure Stack HCI cluster resource page, under Settings, select Configuration.
- Under Azure Hybrid Benefit, the status shows as:
- Activated - indicates Azure Hybrid Benefit is activated
- Not activated - indicates Azure Hybrid Benefit isn't activated
You can also navigate to Cost Analysis > Cost by Resource > Cost by Resource. Expand your Azure Stack HCI resource to check that the meter is under Software Assurance.
Install-Module -Name Az.ResourceGraph
Search-AzGraph -Query "resources | where type == 'microsoft.azurestackhci/clusters'| where name == '${clusterName}' | project id, properties['softwareAssuranceProperties']['softwareAssuranceStatus']"az extension add --name resource-graph
az graph query -q "resources | where type == 'microsoft.azurestackhci/clusters'| where name == '${clusterName}' | project id, properties['softwareAssuranceProperties']['softwareAssuranceStatus']"
You can list all Azure Stack HCI clusters with Azure Hybrid Benefit in a subscription using PowerShell and Azure CLI.
Use PowerShell or Azure CLI to list all Azure Stack HCI clusters with Azure Hybrid Benefit in a subscription.
Install-Module -Name Az.ResourceGraph
Connect-AzAccount -Environment $EnvironmentName -Subscription $subId
Search-AzGraph -Query "Resources | where type == 'microsoft.azurestackhci/clusters' | where properties['softwareAssuranceProperties']['softwareAssuranceStatus'] == 'Enabled' | project id, properties['softwareAssuranceProperties']['softwareAssuranceStatus']"az extension add --name resource-graph
az graph query -q "Resources | where type == 'microsoft.azurestackhci/clusters' | where properties['softwareAssuranceProperties']['softwareAssuranceStatus'] == 'Enabled' | project id, properties['softwareAssuranceProperties']['softwareAssuranceStatus']"
This section describes the errors that you might get when activating Azure Hybrid Benefit for Azure Stack HCI.
Error
Failed to activate Azure Hybrid Benefit. We couldn’t find your Software Assurance contract.
Suggested solution
This error can occur if you have a new Software Assurance contract or if you have set up this Azure subscription recently, but your information isn't updated in the portal yet. If you get this error, reach out to us at AHBonHCI@microsoft.com and share the following information:
- Customer/organization name - the name registered on your Software Assurance contract.
- Azure subscription ID – to which your Azure Stack HCI cluster is registered.
- Agreement number for Software Assurance – this can be found on your purchase order, and is the number you would use to install software from the Volume Licensing Service Center (VLSC).
This section answers questions you might have about Azure Hybrid Benefit for Azure Stack HCI.
For more information about licensing, see Azure Hybrid Benefit for Windows Server.
Yes.
No additional costs are incurred, as Azure Hybrid Benefit is included as part of your Software Assurance benefit.
Consult your Account Manager or licensing partner.
The pricing benefit for Azure Stack HCI host fees takes effect immediately upon activation of Azure Hybrid Benefit for your cluster. The pricing benefit for Windows Server subscription takes effect immediately after you activate both Azure Hybrid Benefit and Windows Server subscription.
For related information, see also: