Skip to content

Commit 2e0bc0e

Browse files
author
Kimmo Forss
committed
Update the software download
1 parent 2794885 commit 2e0bc0e

File tree

2 files changed

+115
-145
lines changed

2 files changed

+115
-145
lines changed

articles/sap/automation/get-started.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,10 @@ Get started quickly with [SAP Deployment Automation Framework](deployment-framew
1919
To get started with SAP Deployment Automation Framework, you need:
2020

2121
- An Azure subscription. If you don't have an Azure subscription, you can [create a free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
22-
- The ability to [download the SAP software](software.md) in your Azure environment.
23-
- An [Azure CLI](/cli/azure/install-azure-cli) installation on your local computer.
24-
- An [Azure PowerShell](/powershell/azure/install-az-ps#update-the-azure-powershell-module) installation on your local computer.
22+
- An SAP USer account with permissions to [download the SAP software](software.md) in your Azure environment. See [SAP S-User](https://support.sap.com/en/my-support/users/welcome.html) for more information.
23+
- An [Azure CLI](/cli/azure/install-azure-cli) installation.
2524
- A service principal to use for the control plane deployment.
25+
- A service principal to use for the workload zone deployment.
2626
- An ability to create an Azure DevOps project if you want to use Azure DevOps for deployment.
2727

2828
Some of the prerequisites might already be installed in your deployment environment. Both Azure Cloud Shell and the deployer have Terraform and the Azure CLI installed.

articles/sap/automation/tutorial.md

Lines changed: 112 additions & 142 deletions
Original file line numberDiff line numberDiff line change
@@ -594,145 +594,6 @@ ${SAP_AUTOMATION_REPO_PATH}/deploy/scripts/deploy_controlplane.sh \
594594
--vault "${vault_name}"
595595
```
596596

597-
598-
599-
## Get SAP software by using the Bill of Materials
600-
601-
The automation framework gives you tools to download software from SAP by using the SAP BOM. The software is downloaded to the SAP library, which acts as the archive for all media required to deploy SAP.
602-
603-
The SAP BOM mimics the SAP maintenance planner. There are relevant product identifiers and a set of download URLs.
604-
605-
A sample extract of a BOM file looks like this example:
606-
607-
```yaml
608-
609-
---
610-
name: 'S41909SPS03_v0010'
611-
target: 'S/4 HANA 1909 SPS 03'
612-
version: 7
613-
614-
product_ids:
615-
dbl: NW_ABAP_DB:S4HANA1909.CORE.HDB.ABAP
616-
scs: NW_ABAP_ASCS:S4HANA1909.CORE.HDB.ABAP
617-
scs_ha: NW_ABAP_ASCS:S4HANA1909.CORE.HDB.ABAPHA
618-
pas: NW_ABAP_CI:S4HANA1909.CORE.HDB.ABAP
619-
pas_ha: NW_ABAP_CI:S4HANA1909.CORE.HDB.ABAPHA
620-
app: NW_DI:S4HANA1909.CORE.HDB.PD
621-
app_ha: NW_DI:S4HANA1909.CORE.HDB.ABAPHA
622-
web: NW_Webdispatcher:NW750.IND.PD
623-
ers: NW_ERS:S4HANA1909.CORE.HDB.ABAP
624-
ers_ha: NW_ERS:S4HANA1909.CORE.HDB.ABAPHA
625-
626-
materials:
627-
dependencies:
628-
- name: HANA_2_00_055_v0005ms
629-
630-
media:
631-
# SAPCAR 7.22
632-
- name: SAPCAR
633-
archive: SAPCAR_1010-70006178.EXE
634-
checksum: dff45f8df953ef09dc560ea2689e53d46a14788d5d184834bb56544d342d7b
635-
filename: SAPCAR
636-
permissions: '0755'
637-
url: https://softwaredownloads.sap.com/file/0020000002208852020
638-
639-
# Kernel
640-
- name: "Kernel Part I ; OS: Linux on x86_64 64bit ; DB: Database independent"
641-
```
642-
643-
For this example configuration, the resource group is `MGMT-NOEU-DEP00-INFRASTRUCTURE`. The deployer key vault name contains `MGMTNOEUDEP00user` in the name. You use this information to configure your deployer's key vault secrets.
644-
645-
1. Connect to your deployer VM for the following steps. A copy of the repo is now there.
646-
647-
1. Add a secret with the username for your SAP user account. Replace `<vaultID>` with the name of your deployer key vault. Also replace `<sap-username>` with your SAP username.
648-
649-
```bash
650-
export key_vault=<vaultID>
651-
sap_username=<sap-username>
652-
653-
az keyvault secret set --name "S-Username" --vault-name $key_vault --value "${sap_username}";
654-
```
655-
656-
1. Add a secret with the password for your SAP user account. Replace `<vaultID>` with your deployer key vault name and replace `<sap-password>` with your SAP password.
657-
658-
> [!NOTE]
659-
> The use of single quotation marks when you set `sap_user_password` is important. The use of special characters in the password can otherwise cause unpredictable results.
660-
661-
```azurecli
662-
sap_user_password='<sap-password>'
663-
664-
az keyvault secret set --name "S-Password" --vault-name "${key_vault}" --value "${sap_user_password}";
665-
```
666-
667-
1. Check the version number of the S/4 1909 SPS03 BOM for the active version.
668-
669-
Record the results.
670-
671-
```bash
672-
673-
ls -d ${DEPLOYMENT_REPO_PATH}/deploy/ansible/BOM-catalog/S41909SPS03* | xargs basename
674-
675-
```
676-
677-
1. Configure your SAP parameters file for the download process. Then, download the SAP software by using Ansible playbooks. Run the following commands:
678-
679-
```bash
680-
cd ~/Azure_SAP_Automated_Deployment/WORKSPACES
681-
cp -Rp ../sap-automation/training-materials/WORKSPACES/BOMS .
682-
cd BOMS
683-
684-
vi sap-parameters.yaml
685-
```
686-
687-
1. Update the `bom_base_name` with the name BOM previously identified.
688-
689-
Your file should look similar to the following example configuration:
690-
691-
```yaml
692-
693-
bom_base_name: S4HANA_2021_FP01_v0001ms
694-
695-
```
696-
697-
1. Replace `<Deployer KeyVault Name>` with the name of the deployer resource group Azure key vault.
698-
699-
Your file should look similar to the following example configuration:
700-
701-
```yaml
702-
703-
bom_base_name: S4HANA_2021_FP01_v0001ms
704-
deployer_kv_name: <Deployer KeyVault Name>
705-
706-
```
707-
708-
1. Ensure that `check_storage_account` is present and set to `false`. This value controls if the SAP library is checked for the file before it's downloaded from SAP.
709-
710-
Your file should look similar to the following example configuration:
711-
712-
```yaml
713-
714-
bom_base_name: S4HANA_2021_FP01_v0001ms
715-
deployer_kv_name: <Deployer KeyVault Name>
716-
BOM_directory: ${HOME}/Azure_SAP_Automated_Deployment/samples/SAP
717-
718-
```
719-
720-
1. Run the Ansible playbooks. One way you can run the playbooks is to use the **Downloader** menu. Run the `download_menu` script.
721-
722-
```bash
723-
~/Azure_SAP_Automated_Deployment/sap-automation/deploy/ansible/download_menu.sh
724-
```
725-
726-
1. Select which playbooks to run.
727-
728-
```bash
729-
1) BoM Downloader
730-
3) Quit
731-
Please select playbook:
732-
```
733-
734-
Select the playbook `1) BoM Downloader` to download the SAP software described in the BOM file into the storage account. Check that the `sapbits` container has all your media for installation.
735-
736597
## Collect workload zone information
737598

738599
1. Collect the following information in a text editor. This information was collected at the end of the "Deploy the control plane" phase.
@@ -899,6 +760,114 @@ ${DEPLOYMENT_REPO_PATH}/deploy/scripts/installer.sh \
899760

900761
Check that the system resource group is now in the Azure portal.
901762

763+
## Get SAP software by using the Bill of Materials
764+
765+
The automation framework gives you tools to download software from SAP by using the SAP BOM. The software is downloaded to the SAP library, which acts as the archive for all media required to deploy SAP.
766+
767+
The SAP BOM mimics the SAP maintenance planner. There are relevant product identifiers and a set of download URLs.
768+
769+
A sample extract of a BOM file looks like this example:
770+
771+
```yaml
772+
773+
---
774+
name: 'S41909SPS03_v0010'
775+
target: 'S/4 HANA 1909 SPS 03'
776+
version: 7
777+
778+
product_ids:
779+
dbl: NW_ABAP_DB:S4HANA1909.CORE.HDB.ABAP
780+
scs: NW_ABAP_ASCS:S4HANA1909.CORE.HDB.ABAP
781+
scs_ha: NW_ABAP_ASCS:S4HANA1909.CORE.HDB.ABAPHA
782+
pas: NW_ABAP_CI:S4HANA1909.CORE.HDB.ABAP
783+
pas_ha: NW_ABAP_CI:S4HANA1909.CORE.HDB.ABAPHA
784+
app: NW_DI:S4HANA1909.CORE.HDB.PD
785+
app_ha: NW_DI:S4HANA1909.CORE.HDB.ABAPHA
786+
web: NW_Webdispatcher:NW750.IND.PD
787+
ers: NW_ERS:S4HANA1909.CORE.HDB.ABAP
788+
ers_ha: NW_ERS:S4HANA1909.CORE.HDB.ABAPHA
789+
790+
materials:
791+
dependencies:
792+
- name: HANA_2_00_055_v0005ms
793+
794+
media:
795+
# SAPCAR 7.22
796+
- name: SAPCAR
797+
archive: SAPCAR_1010-70006178.EXE
798+
checksum: dff45f8df953ef09dc560ea2689e53d46a14788d5d184834bb56544d342d7b
799+
filename: SAPCAR
800+
permissions: '0755'
801+
url: https://softwaredownloads.sap.com/file/0020000002208852020
802+
803+
# Kernel
804+
- name: "Kernel Part I ; OS: Linux on x86_64 64bit ; DB: Database independent"
805+
```
806+
807+
For this example configuration, the resource group is `MGMT-NOEU-DEP00-INFRASTRUCTURE`. The deployer key vault name contains `MGMTNOEUDEP00user` in the name. You use this information to configure your deployer's key vault secrets.
808+
809+
1. Connect to your deployer VM for the following steps. A copy of the repo is now there.
810+
811+
1. Add a secret with the username for your SAP user account. Replace `<vaultID>` with the name of your deployer key vault. Also replace `<sap-username>` with your SAP username.
812+
813+
```bash
814+
export key_vault=<vaultID>
815+
sap_username=<sap-username>
816+
817+
az keyvault secret set --name "S-Username" --vault-name $key_vault --value "${sap_username}";
818+
```
819+
820+
1. Add a secret with the password for your SAP user account. Replace `<vaultID>` with your deployer key vault name and replace `<sap-password>` with your SAP password.
821+
822+
> [!NOTE]
823+
> The use of single quotation marks when you set `sap_user_password` is important. The use of special characters in the password can otherwise cause unpredictable results.
824+
825+
```azurecli
826+
sap_user_password='<sap-password>'
827+
828+
az keyvault secret set --name "S-Password" --vault-name "${key_vault}" --value "${sap_user_password}";
829+
```
830+
831+
1. Configure your SAP parameters file for the download process. Then, download the SAP software by using Ansible playbooks. Run the following commands:
832+
833+
```bash
834+
cd ~/Azure_SAP_Automated_Deployment/WORKSPACES
835+
mkdir BOMS
836+
cd BOMS
837+
838+
vi sap-parameters.yaml
839+
```
840+
841+
1. Update the `bom_base_name` with the name BOM amd replace `<Deployer KeyVault Name>` with the name of the deployer resource group Azure key vault..
842+
843+
Your file should look similar to the following example configuration:
844+
845+
```yaml
846+
847+
bom_base_name: S4HANA_2021_FP01_v0001ms
848+
deployer_kv_name: <Deployer KeyVault Name>
849+
BOM_directory: ${HOME}/Azure_SAP_Automated_Deployment/samples/SAP
850+
851+
```
852+
853+
854+
1. Run the Ansible playbook to download the software. One way you can run the playbooks is to use the **Downloader** menu. Run the `download_menu` script.
855+
856+
```bash
857+
~/Azure_SAP_Automated_Deployment/sap-automation/deploy/ansible/download_menu.sh
858+
```
859+
860+
1. Select which playbooks to run.
861+
862+
```bash
863+
1) BoM Downloader
864+
3) Quit
865+
Please select playbook:
866+
```
867+
868+
Select the playbook `1) BoM Downloader` to download the SAP software described in the BOM file into the storage account. Check that the `sapbits` container has all your media for installation.
869+
870+
902871
## SAP application installation
903872
904873
The SAP application installation happens through Ansible playbooks.
@@ -945,6 +914,10 @@ This playbook installs the HANA database instances.
945914
946915
This playbook invokes the database load task from the primary application server.
947916
917+
### Playbook: HANA HA playbook
918+
919+
This playbook configures HANA system replication and Pacemaker for the HANA database.
920+
948921
### Playbook: PAS install
949922
950923
This playbook installs the primary application server.
@@ -955,9 +928,6 @@ This playbook installs the application servers.
955928
956929
You've now deployed and configured a standalone HANA system. If you need to configure a highly available (HA) SAP HANA database, run the HANA HA playbook.
957930

958-
### Playbook: HANA HA playbook
959-
960-
This playbook configures HANA system replication and Pacemaker for the HANA database.
961931

962932
## Clean up installation
963933

0 commit comments

Comments
 (0)