Download SAP software

You need a copy of the SAP software before you can use the SAP on Azure Deployment Automation Framework. Prepare your Azure environment so you can put the SAP media in your storage account. Then, download the SAP software using Ansible playbooks.

Prerequisites

  • An Azure subscription. If you don't have an Azure subscription, you can create a free account.
  • An SAP user account (SAP-User or S-User account) with software download privileges.

Configure key vault

First, configure your deployer key vault secrets. For this example configuration, the resource group is DEMO-EUS2-DEP00-INFRASTRUCTURE or DEMO-SCUS-DEP00-INFRASTRUCTURE.

  1. Sign in to the Azure CLI with the account you want to use.

    az login
    
  2. Add a secret with the username for your SAP user account. Replace <keyvault-name> with the name of your deployer key vault. Also replace <sap-username> with your SAP username.

    export key_vault=<vaultID>
    sap_username=<sap-username>
    
    az keyvault secret set --name "S-Username" --vault-name $key_vault --value "${sap_username}";
    
  3. Add a secret with the password for your SAP user account. Replace <keyvault-name> with the name of your deployer key vault. Also replace <sap-password> with your SAP password.

    sap_user_password="<sap-password>
    az keyvault secret set --name "S-Password" --vault-name "${key_vault}" --value "${sap_user_password}";
    
  4. There are two other secrets which are needed in this step for the storage account sapbits, are automatically setup by the automation framework. However its always good to verify whether these are existed in your deployer keyvault or not.

    sapbits-access-key
    sapbits-location-base-path
    

Download SAP software

Next, configure your SAP parameters file for the download process. Then, download the SAP software using Ansible playbooks.

Configure parameters file

Configure the SAP parameters file:

  1. Create a new directory called BOMS:

    mkdir -p ~/Azure_SAP_Automated_Deployment/WORKSPACES/BOMS; cd $_
    
  2. Create the SAP parameters YAML file.

    cat <<EOF > sap-parameters.yaml
    ---
    bom_base_name:               S41909SPS03_v0010ms
    kv_name: Name of your Management/Control Plane keyvault
    ..
    EOF
    
  3. Open sap-parameters.yaml in an editor.

    vi sap-parameters.yaml
    
  4. Update the following parameters:

    1. Change the value of bom_base_name to S41909SPS03_v0010ms.

    2. Change the value of kv_name to the name of the deployer key vault.

    3. (If needed) Change the value of secret_prefix to match the prefix in your environment (for example DEV-WEEU-SAP)

Execute Ansible playbooks

Then, execute the Ansible playbooks. One way you can execute the playbooks is to use the validator test menu:

  1. Run the download menu script:

    ~/Azure_SAP_Automated_Deployment/sap-automation/deploy/ansible/download_menu.sh
    
  2. Select the playbook to execute. For example:

    1) BoM Downloader
    2) Quit
    Please select playbook: 
    

Another option is to execute the Ansible playbooks using the command ansible-playbook.

ansible-playbook                                                                                   \
  --user        azureadm                                                                           \
  --extra-vars="@sap-parameters.yaml"                                                              \
  ~/Azure_SAP_Automated_Deployment/sap-automation/deploy/ansible/playbook_bom_downloader.yaml

Next steps