Merge pull request #314082 from Xelu86/dlsapsoft

[Update] Download SAP software

Author: JamesJBarnett

articles/sap/automation/software.md

@@ -3,8 +3,7 @@ title: Download SAP software for the automation framework
 description: Download the SAP software to your Azure environment by using Ansible playbooks to use SAP Deployment Automation Framework.
 author: kimforss
 ms.author: kimforss
-ms.reviewer: kimforss
-ms.date: 11/17/2021
+ms.date: 04/01/2026
 ms.topic: how-to
 ms.service: sap-on-azure
 ms.subservice: sap-automation
@@ -16,7 +15,9 @@ ms.custom:
 
 # Download SAP software
 
-You need a copy of the SAP software before you can use [SAP Deployment Automation Framework](deployment-framework.md). [Prepare your Azure environment](#configure-a-key-vault) so that you can put the SAP media in your storage account. Then, [download the SAP software by using Ansible playbooks](#download-sap-software).
+You need a copy of the SAP software before you can use SAP Deployment Automation Framework. Prepare your Azure environment to store the SAP media in your storage account. Then, download the SAP software by using Ansible playbooks.
+
+For more information about the framework, see [SAP Deployment Automation Framework](deployment-framework.md).
 
 ## Prerequisites
 
@@ -29,89 +30,87 @@ First, configure your deployer key vault secrets. For this example configuration
 
 1. [Sign in to the Azure CLI](/cli/azure/authenticate-azure-cli) with the account you want to use.
 
-    ```azurecli
-    az login
-    ```
+   ```azurecli
+   az login
+   ```
 
-1. 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.
+1. Add a secret with the username for your SAP user account. Replace `<keyvault-name>` with the name of your deployer key vault, and replace `<sap-username>` with your SAP username.
 
-    ```azurecli
-    export key_vault=<vaultID>
-    sap_username=<sap-username>
+   ```azurecli
+   export key_vault=<keyvault-name>
+   sap_username=<sap-username>
 
-    az keyvault secret set --name "S-Username" --vault-name $key_vault --value "${sap_username}";
-    ```
+   az keyvault secret set --name "S-Username" --vault-name $key_vault --value "${sap_username}";
+   ```
 
-1. 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.
+1. Add a secret with the password for your SAP user account. Replace `<sap-password>` with your SAP password.
 
-    ```azurecli
-    sap_user_password="<sap-password>
-    az keyvault secret set --name "S-Password" --vault-name "${key_vault}" --value "${sap_user_password}";
-    ```
+   ```azurecli
+   sap_user_password="<sap-password>"
+   az keyvault secret set --name "S-Password" --vault-name "${key_vault}" --value "${sap_user_password}";
+   ```
 
-1. Two other secrets are needed in this step for the storage account. The automation framework automatically sets up `sapbits`. It's always a good practice to verify whether they existed in your deployer key vault or not.
+1. Verify that the following secrets exist in your deployer key vault. The automation framework automatically sets up `sapbits`, but confirm that the secrets are present.
 
-    ```text
-    sapbits-access-key
-    sapbits-location-base-path
-    ```
+   ```text
+   sapbits-access-key
+   sapbits-location-base-path
+   ```
 
-## Download SAP software
+## Download the SAP software with Ansible playbooks
 
-Next, [configure your SAP parameters file](#configure-the-parameters-file) for the download process. Then, [download the SAP software by using Ansible playbooks](#download-sap-software).
+Next, [configure your SAP parameters file](#configure-the-parameters-file) for the download process. Then, [run the Ansible playbooks](#run-the-ansible-playbooks) to download the software.
 
 ### Configure the parameters file
 
 To configure the SAP parameters file:
 
-1. Create a new directory called `BOMS`.
+1. Create a directory called `BOMS`.
 
-    ```bash
-    mkdir -p ~/Azure_SAP_Automated_Deployment/WORKSPACES/BOMS; cd $_
-    ```
+   ```bash
+   mkdir -p ~/Azure_SAP_Automated_Deployment/WORKSPACES/BOMS; cd $_
+   ```
 
 1. Create the SAP parameters YAML file.
 
-    ```bash
-    cat <<EOF > sap-parameters.yaml
-    ---
-    bom_base_name:               S41909SPS03_v0010ms
-    kv_name: Name of your Management/Control Plane keyvault
-    ..
-    EOF
-    ```
+   ```bash
+   cat <<EOF > sap-parameters.yaml
+   ---
+   bom_base_name:               S41909SPS03_v0010ms
+   kv_name: Name of your Management/Control Plane keyvault
+   ..
+   EOF
+   ```
 
-1. Open `sap-parameters.yaml` in an editor.
+1. Open `sap-parameters.yaml` in an editor and verify the following values:
 
-    ```bash
-    vi sap-parameters.yaml
-    ``` 
+   ```bash
+   vi sap-parameters.yaml
+   ```
 
-1. Update the following parameters:
+   1. Confirm that `bom_base_name` is set to the correct Bill of Materials name for your deployment (for example, `S41909SPS03_v0010ms`).
 
-    1. Change the value of `bom_base_name` to `S41909SPS03_v0010ms`.
+   1. Confirm that `kv_name` matches the name of your deployer key vault.
 
-    1. Change the value of `kv_name` to the name of the deployer key vault.
-   
-    1. (If needed) Change the value of `secret_prefix` to match the prefix in your environment (for example, `DEV-WEEU-SAP`).
+   1. (If needed) Update the value of `secret_prefix` to match the prefix in your environment (for example, `DEV-WEEU-SAP`).
 
 ### Run the Ansible playbooks
 
-You're ready to run the Ansible playbooks. One way you can run the playbooks is to use the validator test menu.
+You're ready to run the Ansible playbooks. One way to run the playbooks is to use the validator test menu.
 
 1. Run the download menu script:
 
-    ```bash
-    ~/Azure_SAP_Automated_Deployment/sap-automation/deploy/ansible/download_menu.sh
-    ```
+   ```bash
+   ~/Azure_SAP_Automated_Deployment/sap-automation/deploy/ansible/download_menu.sh
+   ```
 
 1. Select the playbook to run. For example:
-    
-    ```text
-    1) BoM Downloader
-    2) Quit
-    Please select playbook: 
-    ```
+
+   ```text
+   1) BoM Downloader
+   2) Quit
+   Please select playbook:
+   ```
 
 Another option is to run the Ansible playbooks by using the `ansible-playbook` command.