Install SAP software for a distributed HA system with custom resource names by using Azure CLI

Azure Center for SAP solutions enables you to deploy and manage SAP systems on Azure. This quickstart shows you how to install SAP software for infrastructure deployed for an SAP system. In the previous step, you created infrastructure for an SAP system with a highly available distributed architecture. You used Azure Center for SAP solutions with Azure CLI and provided customized resource names for the deployed Azure resources.

After you deploy infrastructure and install SAP software, you can manage and monitor the system through the Virtual Instance for SAP solutions (VIS) resource. For example, you can:

View and track the SAP system as an Azure resource, called the Virtual Instance for SAP solutions (VIS).
Get recommendations for your SAP infrastructure and operating system configurations based on quality checks that evaluate best practices for SAP on Azure.
Get health and status information about your SAP system.
Start and stop the SAP application tier.
Start and stop individual instances of Advanced Business Application Programming SAP Central Services (ASCS), Application server, and HANA database.
Monitor the Azure infrastructure metrics for the SAP system resources.
View cost analysis for the SAP system.

Prerequisites

An Azure subscription. If you don't already have an Azure subscription, create a free account.
An Azure account with Azure Center for SAP solutions administrator and Managed Identity Operator role access to the subscriptions and resource groups in which you create the Virtual Instance for SAP solutions (VIS) resource.
A User-assigned managed identity that has Azure Center for SAP solutions service role access on the subscription or at least all resource groups (compute, network, storage).
A storage account where you store the SAP media.
Reader and Data Access role assigned to the User-assigned managed identity on the storage account where you store the SAP media.
A network set up for your infrastructure deployment.
A deployment of S/4HANA infrastructure.
The SSH private key for the virtual machines in the SAP system. You generated this key during the infrastructure deployment.
The SAP installation media available in a storage account. For more information, see Download the SAP installation media.
The JSON configuration file that you used to create infrastructure in the previous step for the SAP system by using PowerShell or Azure CLI.
The service principal identifier (SPN ID) and password to authorize the Azure fence agent (fencing device) against Azure resources, because you're installing a highly available SAP system.
- For an example, see the Red Hat documentation for Creating a Microsoft Entra application.
- To avoid frequent password expiry, use Azure CLI to create the service principal identifier and password instead of the Azure portal.

Azure Cloud Shell

Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. You can use either Bash or PowerShell with Cloud Shell to work with Azure services. You can use the Cloud Shell preinstalled commands to run the code in this article, without having to install anything on your local environment.

To start Azure Cloud Shell:

Option	Example/Link
Select Try It in the upper-right corner of a code or command block. Selecting Try It doesn't automatically copy the code or command to Cloud Shell.
Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser.
Select the Cloud Shell button on the menu bar at the upper right in the Azure portal.

To use Azure Cloud Shell:

Start Cloud Shell.
Select the Copy button on a code block (or command block) to copy the code or command.
Paste the code or command into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux, or by selecting Cmd+Shift+V on macOS.
Select Enter to run the code or command.

Create a JSON configuration file

The JSON file for installation of SAP software is similar to the one used to deploy infrastructure for SAP, with an added section for SAP software configuration.

The software configuration section requires the following inputs:

Software installation type: Keep this value as SAPInstallWithoutOSConfig.
BOM URL: The BOM file path. For example, https://<your-storage-account>.blob.core.windows.net/sapbits/sapfiles/boms/S41909SPS03_v0010ms.yaml.
Software version: Azure Center for SAP solutions supports:
- SAP S/4HANA 1909 SPS03
- SAP S/4HANA 2020 SPS 03
- SAP S/4HANA 2021 ISS 00
- SAP S/4HANA 2022 ISS 00
Storage account ID: The resource ID for the storage account where the BOM file is created.
Fencing Client ID: The client identifier for the STONITH Fencing Agent service principal (required for HA deployments).
Fencing Client Password: The password for the Fencing Agent service principal (required for HA deployments).

You can use the sample software installation payload file.