Automation scripts for the Deployment of SAP S/4HANA High Availability Multi-Zone or Single-Zone using Terraform and Ansible

Description

This automation solution is designed for SAP S/4HANA High Availability Deployment in IBM CLoud Multi-Zone or Single-Zone distribution, using IBM Cloud Schematics or Terraform CLI. The SAP solution will be deployed in an existing IBM Cloud Gen2 VPC, using a deployed bastion host with secure remote SSH access.

The solution is based on Terraform and Ansible playbooks executed using IBM Cloud Schematics or Terraform CLI and it is implementing a 'reasonable' set of best practices for SAP VSI host configuration. The automation has support for the following versions: Terraform >= 1.5.7 and IBM Cloud provider for Terraform >= 1.57.0.

It contains:

Terraform scripts to provision:
- one Power Placement group for all four VMs created by this solution
- four VSIs, in an EXISTING VPC, with Subnet and Security Group configs. The VSIs scope: two for the HANA database cluster and two for the SAP application cluster.
Terraform scripts to provision and configure:
- three Application Load Balancers for HANA DB, SAP ASCS/ERS
- one VPC DNS service used to map the ALB FQDN to the SAP ASCS/ERS and Hana Virtual hostnames
- seven File shares for VPC
Bash scripts:
- to check the prerequisites required by SAP VSIs deployment
- to integrate into a single step the VPC virtual resources provisioning and the SAP S/4HANA HA cluster solution installation.
Ansible scripts for:
- OS requirements installation and configuration for SAP applications
- cluster components installation
- SAP application cluster configuration and SAP HANA cluster configuration
- HANA installation
- HANA system replica configuration
- ASCS and ERS instances installation
- DB load
- primary and additional application servers installation

The following resources are created during the deployment:

two SAP VMs for ASCS/ERS HA running in a pacemaker cluster; SAP PAS is running on one of the cluster node and SAP AAS on the second node
two HANA VMs, with HSR Sync replication, running in a pacemaker cluster; the primary node is active and the secondary node runs in standby mode
three ALBs used for Virtual IP/hostname for ASCS, ERS and HANA.
one DNS service to map the virtual names for ASCS/ERS/HANA to ALB hostname
seven File shares to be used by SAP.

Notes:

For Network latency between VPC Zones and Regions please check the"VPC Network latency dashboards" using the link bellow and run your own measurement according with SAP note "500235 - Network Diagnosis with NIPING" to perform a latency check using SAP tool niping: https://cloud.ibm.com/docs/vpc?topic=vpc-network-latency-dashboard
- The results reported are as measured. There are no performance guarantees implied by these measurement.
- These statistics provide visibility into latency between all regions and zones to help you plan the optimal selection for your cloud deployment and plan for scenarios, such as data residency and performance
ZONE_1 is the availability zone for DB_HOSTNAME_1 and APP_HOSTNAME_1 VSIs.
SUBNET_1 is an EXISTING Subnet, where DB_HOSTNAME_1 and APP_HOSTNAME_1 VSIs will be created.
ZONE_2 is the availability zone for DB_HOSTNAME_2 and APP_HOSTNAME_2 VSIs.
SUBNET_2 is an EXISTING Subnet, where DB_HOSTNAME_2 and APP_HOSTNAME_2 VSIs will be created.
If the values of the variables ZONE_1 and ZONE_2 are equal and the values of the variables SUBNET_1 and SUBNET_2 are also equal, an SAP Single-Zone Deployment will be done in ZONE_1, SUBNET_1.
If the variable values from ZONE_1, SUBNET_1 are different than ZONE_2, SUBNET_2, an SAP Multi-Zone Deployment will be executed.
Supported zones: https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones-vpc.
The list of EXISTING Subnets is available here: https://cloud.ibm.com/vpc-ext/network/subnets.
Each Subnet must have Internet access throught a Public Gateway.

1.1 Installation media
1.2 Prerequisites
1.3 VSI Configuration
1.4 VPC Configuration
1.5 Files description and structure
1.6 General input variabiles
2.1 Executing the deployment of HA SAP S/4HANA installation in GUI (Schematics)
2.2 Executing the deployment of HA SAP S/4HANA installation in CLI
3.1 Related links

1.1 Installation media

SAP HANA installation media used for this deployment is the default one for SAP HANA, platform edition 2.0 SPS05 available at SAP Support Portal under INSTALLATION AND UPGRADE area and it has to be provided manually in the input parameter file.

SAP S/4HANA installation media used for this deployment is the default one for SAP S/4HANA 2023 available at SAP Support Portal under INSTALLATION AND UPGRADE area and it has to be provided manually in the input parameter file.

SAP Software Provisioning Manager used for S/4HANA 2023 is 2.0 SP17 and it's recommended to use the same version or higher.

1.2 Prerequisites

A Deployment Server (BASTION Server) in the same VPC should exist. For more information, see https://github.com/IBM-Cloud/sap-bastion-setup.
From the SAP Portal, download the SAP kits on the Deployment Server. Make note of the download locations. Ansible decompresses all of the archive kits.
Create or retrieve an IBM Cloud API key. The API key is used to authenticate with the IBM Cloud platform, determine your permissions for IBM Cloud services and it is required for the functioning of the cluster stonith devices in IBM VPC.
Create or retrieve your SSH key ID. You need the 40-digit UUID for the SSH key, not the SSH key name.

1.3 VSI Configuration

Red Hat Enterprise Linux 8 for SAP HANA (amd64) is installed on the VSIs and SSH keys are configured to allow the access as root user vis SSH. The following storage volumes created for DB and SAP APP VSI:

HANA DBs VSI Disks:

the disk sizes depend on the selected profile, according to Intel Virtual Server certified profiles on VPC infrastructure for SAP HANA - Last updated 2022-01-28

Note: LVM will be used for /hana/data, hana/log, /hana/shared and /usr/sap, for all storage profiles, excepting vx2d-44x616 and vx2d-88x1232 profiles, where /hana/data and /hana/shared won't be manged by LVM, according to Intel Virtual Server certified profiles on VPC infrastructure for SAP HANA - Last updated 2022-01-28 and to Storage design considerations - Last updated 2022-05-19

For example, in case of deploying a HANA VM, using the default value for VSI profile mx2-16x128, the automation will execute the following storage setup:

3 volumes x 500 GB each for <sid>_hana_vg volume group
- the volume group will contain the following logical volumes (created with three stripes):
  - <sid>_hana_data_lv - size 988 GB
  - <sid>_hana_log_lv - size 256 GB
  - <sid>_hana_shared - size 256 GB
1 volume x 50 GB for /usr/sap (volume group: <sid>_usr_sap_vg, logical volume: <sid>_usr_sap_lv)
1 volume x 10 GB for a 2 GB SWAP logical volume (volume group: <sid>_swap_vg, logical volume: <sid>_swap_lv)

SAP APPs VSI Disks:

1 disk with 10 IOPS / GB - SWAP (the size depends on the OS profile used, for bx2-4x16 the size will be 48 GB)

1.4 VPC Configuration

The Security Rules inherited from BASTION deployment are the following:

Allow all traffic in the Security group for private networks.
Allow outbound traffic (ALL for port 53, TCP for ports 80, 443, 8443)
Allow inbound SSH traffic (TCP for port 22) from IBM Schematics Servers.

1.5 Files description and structure

The solution is based on Terraform and Ansible playbooks executed throught remote&local-exec tf options by IBM Schematics or Terraform CLI and it has the following structure:

modules - directory containing the terraform modules.
ansible - directory containing the SAP ansible playbooks.
main.tf - contains the configuration of the VSI for the deployment of the current SAP solution.
output.tf - contains the code for the information to be displayed after the VSI is created (VPC, Hostname, Private IP).
integration*.tf & generate*.tf files - contain the integration code that makes the SAP variabiles from Terraform available to Ansible.
provider.tf - contains the IBM Cloud Provider data in order to run terraform init command.
variables.tf - contains variables for the VPC and VSI.
versions.tf - contains the minimum required versions for terraform and IBM Cloud provider.
sch.auto.tfvars - contains programatic variables.

1.6 General Input variables

VSI input parameters:

Parameter	Description
IBMCLOUD_API_KEY	IBM Cloud API key (Sensitive* value). The IBM Cloud API Key can be created here
SSH_KEYS	List of IBM Cloud SSH Keys UUIDs that are allowed to connect via SSH, as root, to the VSI. The SSH Keys should be created for the same region as the Cloud resources for SAP. Can contain one or more IDs. The list of SSH Keys is available here. Sample input (use your own SSH UUIDs from IBM Cloud): ["r010-57bfc315-f9e5-46bf-bf61-d87a24a9ce7a", "r010-3fcd9fe7-d4a7-41ce-8bb3-d96e936b2c7e"]
RESOURCE_GROUP	The name of an EXISTING Resource Group for VSIs and Volumes resources. Default value: "Default". The list of Resource Groups is available here.
REGION	The cloud region where to deploy the solution. The regions and zones for VPC are available here. Supported locations in IBM Cloud Schematics here. Sample value: eu-de.
VPC	The name of an EXISTING VPC. Must be in the same region as the solution to be deployed. The list of VPCs is available here
ZONE_1	Availability zone for DB_HOSTNAME_1 and APP_HOSTNAME_1 VSIs, in the same VPC. Supported zones: https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones-vpc.
SUBNET_1	The name of an EXISTING Subnet, in the same VPC, ZONE_1, where DB_HOSTNAME_1 and APP_HOSTNAME_1 VSIs will be created. The list of Subnets is available here: https://cloud.ibm.com/vpc-ext/network/subnets
ZONE_2	Availability zone for DB_HOSTNAME_2 and APP_HOSTNAME_2 VSIs, in the same VPC. Supported zones: https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones-vpc. OBS.: If the same value as for ZONE_1 is used, and the value for SUBNET_1 is the same with the value for SUBNET_2, the deployment will be done in a single zone. If the values for ZONE_1, SUBNET_1 are different than the ones for ZONE_2, SUBNET_2 then an SAP Multizone deployment will be done.
SUBNET_2	The name of an EXISTING Subnet, in the same VPC, ZONE_2, where DB_HOSTNAME_2 and APP_HOSTNAME_2 VSIs will be created. The list of Subnets is available here: https://cloud.ibm.com/vpc-ext/network/subnets. OBS.: If the same value as for SUBNET_1 is used, and the value for ZONE_1 is the same with the value for ZONE_2, the deployment will be done in a single zone. If the values for ZONE_1, SUBNET_1 are different than the ones for ZONE_2, SUBNET_2 then it an SAP Multizone deployment will be done.
SECURITY_GROUP	The name of an EXISTING Security group for the same VPC. It can be found at the end of the Bastion Server deployment log, in "Outputs", before "Command finished successfully" message. The list of Security Groups is available here: https://cloud.ibm.com/vpc-ext/network/securityGroups.
DOMAIN_NAME	The Domain Name used for DNS and ALB. Duplicates are not allowed. The list with DNS resources can be searched here. Sample value: "example.com". (See Obs.)*
SHARE_PROFILE	The Storage Profile for the File Share. More details here. Default value: SHARE_PROFILE = "dp2".
SHARE SIZES	Custom File Shares Sizes for SAP mounts. Sample values: USRSAP_SAPMNT = "20" , USRSAP_TRANS = "80".
[DB/APP]_VIRT_HOSTNAMES	HANA/ASCS/ERS virtual hostnames. If the default values are used, they will be automatically converted to: "db<hana_sid>hana", "sap<sap_sid>ascs", "sap<sap_sid>ers".
[DB/APP]_HOSTNAMES	SAP HANA/APP VSI Hostnames, in HANA/SAP cluster. Each hostname should be up to 13 characters as required by SAP. For more information on rules regarding hostnames for SAP systems, check SAP Note 611361: Hostnames of SAP ABAP Platform servers. If the default values are used, they will be automatically converted to: : DB_HOSTNAME_1/2 = "hanadb-<hana_sid>-1/2", APP_HOSTNAME_1/2 = "sapapp-<sap_sid>-1/2".
DB_PROFILE	The instance profile used for the HANA VSI. The list of certified profiles for HANA VSIs is available here. Details about all x86 instance profiles are available here. For more information about supported DB/OS and IBM Gen 2 Virtual Server Instances (VSI), check SAP Note 2927211: SAP Applications on IBM Virtual Private Cloud Default value: DB_PROFILE = "mx2-16x128"
APP_PROFILE	The profile used for the APP VSI. A list of profiles is available here. For more information about supported OS and IBM Gen 2 Virtual Server Instances (VSI), check SAP Note 2927211: SAP Applications on IBM Virtual Private Cloud Default value: APP_PROFILE = "bx2-4x16".
[DB/APP]_IMAGE	The OS image used for the HANA/APP VSI. You must use the Red Hat Enterprise Linux 8 for SAP HANA (amd64) image for all VMs as this image contains the required SAP and HA subscriptions. A list of images is available here Default value: "ibm-redhat-8-6-amd64-sap-hana-5"

SAP input parameters:

Parameter	Description	Requirements
S4HANA_VERSION	The version of S/4HANA.	Supported values: 2023, 2022, 2021, 2020.
HANA_SID	The SAP system ID identifies the SAP HANA system. (See Obs.)*	Consists of exactly three alphanumeric characters Has a letter for the first character Does not include any of the reserved IDs listed in SAP Note 1979280
HANA_SYSNO	Specifies the instance number of the SAP HANA system	Two-digit number from 00 to 97 Must be unique on a host
HANA_SYSTEM_USAGE	System Usage	Default: custom Valid values: production, test, development, custom
HANA_COMPONENTS	SAP HANA Components	Default: server Valid values: all, client, es, ets, lcapps, server, smartda, streaming, rdsync, xs, studio, afl, sca, sop, eml, rme, rtl, trp
KIT_SAPHANA_FILE	Path to SAP HANA ZIP file	As downloaded from SAP Support Portal.
SAP_SID	The SAP system ID identifies the entire SAP system. (See Obs.)*	Consists of exactly three alphanumeric characters Has a letter for the first character Does not include any of the reserved IDs listed in SAP Note 1979280
SAP_ASCS_INSTANCE_NUMBER	Technical identifier for internal processes of ASCS	Two-digit number from 00 to 97 Must be unique on a host
SAP_ERS_INSTANCE_NUMBER	Technical identifier for internal processes of ERS	Two-digit number from 00 to 97 Must be unique on a host
SAP_CI_INSTANCE_NUMBER	Technical identifier for internal processes of PAS	Two-digit number from 00 to 97 Must be unique on a host
SAP_AAS_INSTANCE_NUMBER	Technical identifier for internal processes of AAS	Two-digit number from 00 to 97 Must be unique on a host
HDB_CONCURRENT_JOBS	Number of concurrent jobs used to load and/or extract archives to HANA Host	Default: 23
KIT_SAPCAR_FILE	Path to sapcar binary	As downloaded from SAP Support Portal.
KIT_SWPM_FILE	Path to SWPM archive (SAR)	As downloaded from SAP Support Portal.
KIT_SAPEXE_FILE	Path to SAP Kernel OS archive (SAR)	As downloaded from SAP Support Portal.
KIT_SAPEXEDB_FILE	Path to SAP Kernel DB archive (SAR)	As downloaded from SAP Support Portal.
KIT_IGSEXE_FILE	Path to IGS archive (SAR)	As downloaded from SAP Support Portal.
KIT_IGSHELPER_FILE	Path to IGS Helper archive (SAR)	As downloaded from SAP Support Portal.
kit_saphostagent_file	Path to SAP Host Agent archive (SAR)	As downloaded from SAP Support Portal.
KIT_HDBCLIENT_FILE	Path to HANA DB client archive (SAR)	As downloaded from SAP Support Portal.
KIT_S4HANA_EXPORT	Path to S/4HANA Installation Export dir	The archives downloaded from SAP Support Portal should be present in this path.

Obs*:

The configured instance number must be different for each components (ASCS, ERS, CI, AAS).
Sensitive - The variable value is not displayed in your Schematics logs and it is hidden in the input field.
SAP Passwords
- The passwords for the SAP system will be asked interactively during terraform plan step and will not be available after the deployment. (Sensitive* values).

Parameter	Description	Requirements
SAP_MAIN_PASSWORD	Common password for all SAP users that are created during the installation	It must be 8 to 14 characters long It must contain at least one digit (0-9) It must not contain \ (backslash) and " (double quote) Master Password must contain at least one upper-case character
HANA_MAIN_PASSWORD	HANA system master password	It must be 8 to 14 characters long It must contain at least one digit (0-9) It must not contain \ (backslash) and " (double quote) Master Password must contain at least one upper-case character
HA_PASSWORD	HA cluster password	It must be 8 to 14 characters long It must contain at least one digit (0-9) It must not contain \ (backslash) and " (double quote) Master Password must contain at least one upper-case character

The following parameters should have the same values as the ones set for the BASTION server: REGION, ZONE, VPC, SUBNET, SECURITYGROUP.
DOMAIN_NAME variable rules:
- it should contain at least one "." as a separator. It is a private domain and it is not reacheable to and from the outside world.
- it could be like a subdomain name. Ex.: staging.example.com
- it can only use letters, numbers, and hyphens.
- hyphens cannot be used at the beginning or end of the domain name.
- it can't be used a domain name that is already in use.
- domain names are not case sensitive.
The following SAP "SID" values are reserved and are not allowed to be used: ADD, ALL, AMD, AND, ANY, ARE, ASC, AUX, AVG, BIT, CDC, COM, CON, DBA, END, EPS, FOR, GET, GID, IBM, INT, KEY, LOG, LPT, MAP, MAX, MIN, MON, NIX, NOT, NUL, OFF, OLD, OMS, OUT, PAD, PRN, RAW, REF, ROW, SAP, SET, SGA, SHG, SID, SQL, SUM, SYS, TMP, TOP, UID, USE, USR, VAR".
For any manual change in the terraform code, you have to make sure that you use a certified image based on the SAP NOTE: 2927211.

Installation media validated for this solution:

S/4HANA 2023

Component	Version	Filename
SAPCAR	7.22	SAPCAR_1010-70006178.EXE
SOFTWARE PROVISIONING MGR	2.0 SP17 PL 0	SWPM20SP17_0-80003424.SAR
SAP KERNEL	7.93 64-BIT UNICODE	SAPEXE_60-70007807.SAR SAPEXEDB_60-70007806.SAR
SAP IGS	7.81 PL 4	igsexe_4-70005417.sar
SAP IGS HELPER	PL 17	igshelper_17-10010245.sar
SAP HOST AGENT	7.22 SP61	SAPHOSTAGENT61_61-80004822.SAR
HANA CLIENT	2.18	IMDB_CLIENT20_018_27-80002082.SAR
HANA DB	2.0 SPS07 rev73	51057281.ZIP

OS images validated for this solution:

OS version	Image	Role
Red Hat Enterprise Linux 8.6 for SAP HANA (amd64)	ibm-redhat-8-6-amd64-sap-hana-6	DB/APP
Red Hat Enterprise Linux 8.4 for SAP HANA (amd64)	ibm-redhat-8-4-amd64-sap-hana-10	DB/APP

S/4HANA 2022

Component	Version	Filename
SAPCAR	7.22	SAPCAR_1010-70006178.EXE
SOFTWARE PROVISIONING MGR	2.0 SP15 PL 5	SWPM20SP15_5-80003424.SAR
SAP KERNEL	7.89 64-BIT UNICODE PL 200	SAPEXE_200-70006642.SAR SAPEXEDB_200-70006641.SAR
SAP IGS	7.81 PL 4	igsexe_4-70005417.sar
SAP IGS HELPER	PL 17	igshelper_17-10010245.sar
SAP HOST AGENT	7.22 SP61	SAPHOSTAGENT61_61-80004822.SAR
HANA CLIENT	2.18	IMDB_CLIENT20_018_27-80002082.SAR
HANA DB	2.0 SPS07 rev73	51057281.ZIP

OS images validated for this solution:

OS version	Image	Role
Red Hat Enterprise Linux 8.6 for SAP HANA (amd64)	ibm-redhat-8-6-amd64-sap-hana-6	DB/APP
Red Hat Enterprise Linux 8.4 for SAP HANA (amd64)	ibm-redhat-8-4-amd64-sap-hana-10	DB/APP

S/4HANA 2021

Component	Version	Filename
SAPCAR	7.22	SAPCAR_1010-70006178.EXE
SOFTWARE PROVISIONING MGR	2.0 SP15 PL 5	SWPM20SP15_5-80003424.SAR
SAP KERNEL	7.89 64-BIT UNICODE PL 200	SAPEXE_200-70006642.SAR SAPEXEDB_200-70006641.SAR
SAP IGS	7.81 PL 4	igsexe_4-70005417.sar
SAP IGS HELPER	PL 17	igshelper_17-10010245.sar
SAP HOST AGENT	7.22 SP61	SAPHOSTAGENT61_61-80004822.SAR
HANA CLIENT	2.18	IMDB_CLIENT20_018_27-80002082.SAR
HANA DB	2.0 SPS07 rev73	51057281.ZIP

OS images validated for this solution:

OS version	Image	Role
Red Hat Enterprise Linux 8.6 for SAP HANA (amd64)	ibm-redhat-8-6-amd64-sap-hana-6	DB/APP
Red Hat Enterprise Linux 8.4 for SAP HANA (amd64)	ibm-redhat-8-4-amd64-sap-hana-10	DB/APP

S/4HANA 2020

Component	Version	Filename
SAPCAR	7.22	SAPCAR_1010-70006178.EXE
SOFTWARE PROVISIONING MGR	2.0 SP15 PL 5	SWPM20SP15_5-80003424.SAR
SAP KERNEL	7.85 64-BIT UNICODE PL 300	SAPEXE_300-80005374.SAR SAPEXEDB_300-80005373.SAR
SAP IGS	7.81 PL 3	igsexe_3-70005417.sar
SAP IGS HELPER	PL 17	igshelper_17-10010245.sar
SAP HOST AGENT	7.22 SP61	SAPHOSTAGENT61_61-80004822.SAR
HANA CLIENT	2.17	IMDB_CLIENT20_017_22-80002082.SAR
HANA DB	2.0 SPS07 rev73	51057281.ZIP

OS images validated for this solution:

OS version	Image	Role
Red Hat Enterprise Linux 8.6 for SAP HANA (amd64)	ibm-redhat-8-6-amd64-sap-hana-6	DB/APP
Red Hat Enterprise Linux 8.4 for SAP HANA (amd64)	ibm-redhat-8-4-amd64-sap-hana-10	DB/APP

Terraform version used to validate this solution:

The deployment was validated for Terraform 1.5.7

2.1 Executing the deployment of HA SAP S/4HANA installation in GUI (Schematics)

IBM Cloud API Key

The IBM Cloud API Key should be provided as input value of type sensitive for "ibmcloud_api_key" variable, in IBM Schematics -> Workspaces -> <Workspace name> -> Settings menu. The IBM Cloud API Key can be created here.

Input parameters

Beside the parameters described in General input variables Section, there are specific input variables for Schematics:

Parameter	Description
PRIVATE_SSH_KEY	id_rsa private key content (Sensitive* value) in OpenSSH format. This private key is used only during the terraform provisioning and it is recommended to be changed after the SAP deployment.
ID_RSA_FILE_PATH	The file path for the private ssh key. It will be automatically generated. If it is changed, it must contain the relative path from git repo folders. Example: ansible/id_rsa_abap_ase-syb_std
BASTION_FLOATING_IP	The FLOATING IP from the Bastion Server. It can be found at the end of the Bastion Server deployment log, in "Outputs", before "Command finished successfully" message.

Steps to follow:

Make sure that you have the required IBM Cloud IAM permissions to create and work with VPC infrastructure and you are assigned the correct permissions to create the workspace in Schematics and deploy resources.
Generate an SSH key. The SSH key is required to access the provisioned VPC virtual server instances via the bastion host. After you have created your SSH key, make sure to upload this SSH key to your IBM Cloud account in the VPC region and resource group where you want to deploy the SAP solution
Create the Schematics workspace:
1. From the IBM Cloud menu select Schematics.
  - Push the Create workspace button.
  - Provide the URL of the Github repository of this solution
  - Select the latest Terraform version.
  - Click on Next button
  - Provide a name, the resources group and location for your workspace
  - Push Next button
  - Review the provided information and then push Create button to create your workspace
2. On the workspace Settings page,
  - In the Input variables section, review the default values for the input variables and provide alternatives if desired.
  - Click Save changes.
From the workspace Settings page, click Generate plan
From the workspace Jobs page, the logs of your Terraform execution plan can be reviewed.
Apply your Terraform template by clicking Apply plan.
Review the logs to ensure that no errors occurred during the provisioning, modification, or deletion process.

The output of the Schematics Apply Plan will dispaly the public/private IP addresses of the VSI host, the hostname and the VPC.

2.2 Executing the deployment of HA SAP S/4HANA installation in CLI

IBM Cloud API Key

For the script configuration add your IBM Cloud API Key in terraform planning phase command 'terraform plan --out plan1'. You can create an API Key here.

Input parameter file

The input.auto.tfvars file must be used to make the desired configuration, as in the example bellow:

VSI input parameters

##########################################################
# General VPC variables:
##########################################################

REGION = "eu-de"
# The cloud region where to deploy the solution. Supported regions: https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones-vpc
# Example: REGION = "eu-de"

DOMAIN_NAME = "ha.mzexample.com"
# The DOMAIN_NAME variable should contain at least one "." as a separator. It is a private domain and it is not reacheable to and from the outside world.
# The DOMAIN_NAME variable could be like a subdomain name. Ex.: staging.example.com
# Domain names can only use letters, numbers, and hyphens.
# Hyphens cannot be used at the beginning or end of the domain name.
# You can't use a domain name that is already in use.
# Domain names are not case sensitive.

ASCS_VIRT_HOSTNAME = "sapascs"
# ASCS Virtual Hostname
# Default value: sapascs
# When the default value is used, the virtual hostname will automatically be changed based on <SAP_SID> to "sap<sap_sid>ascs"

ERS_VIRT_HOSTNAME = "sapers"
# ERS Virtual Hostname
# Default value: sapers
# When the default value is used, the virtual hostname will automatically be changed based on <SAP_SID> to "sap<sap_sid>ers"

HANA_VIRT_HOSTNAME = "dbhana"
# Hana Virtual Hostname
# Default value: dbhana
# When the default value is used, the virtual hostname will automatically be changed based on <SAP_SID> to "db<hana_sid>hana"

VPC = "ic4sap"
# The name of an EXISTING VPC. Must be in the same region as the solution to be deployed. The list of VPCs is available here: https://cloud.ibm.com/vpc-ext/network/vpcs.
# Example: VPC = "ic4sap"

ZONE_1 = "eu-de-1"
# Availability zone for DB_HOSTNAME_1 and APP_HOSTNAME_1 VSIs, in the same VPC. Supported zones: https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones-vpc
# Example: ZONE = "eu-de-1"

SUBNET_1 = "ic4sap-subnet_1"
# The name of an EXISTING Subnet, in the same VPC, ZONE_1, where DB_HOSTNAME_1 and APP_HOSTNAME_1 VSIs will be created. The list of Subnets is available here: https://cloud.ibm.com/vpc-ext/network/subnets
# Example: SUBNET = "ic4sap-subnet_1"

ZONE_2 = "eu-de-2"
# Availability zone for DB_HOSTNAME_2 and APP_HOSTNAME_2 VSIs, in the same VPC. Supported zones: https://cloud.ibm.com/docs/containers?topic=containers-regions-and-zones#zones-vpc. 
# If the same value as for ZONE_1 is used, and the value for SUBNET_1 is the same with the value for SUBNET_2, the deployment will be done in a single zone. If the values for ZONE_1, SUBNET_1 are different than the ones for ZONE_2, SUBNET_2 then an SAP Multizone deployment will be done.
# Example: ZONE = "eu-de-2"

SUBNET_2 = "ic4sap-subnet_2"
# The name of an EXISTING Subnet, in the same VPC, ZONE_2, where DB_HOSTNAME_2 and APP_HOSTNAME_2 VSIs will be created. The list of Subnets is available here: https://cloud.ibm.com/vpc-ext/network/subnets. 
# If the same value as for SUBNET_1 is used, and the value for ZONE_1 is the same with the value for ZONE_2, the deployment will be done in a single zone. If the values for ZONE_1, SUBNET_1 are different than the ones for ZONE_2, SUBNET_2 then it an SAP Multizone deployment will be done.
# Example: SUBNET = "ic4sap-subnet_2"

SECURITY_GROUP = "ic4sap-securitygroup"
# The name of an EXISTING Security group for the same VPC. It can be found at the end of the Bastion Server deployment log, in \"Outputs\", before \"Command finished successfully\" message. The list of Security Groups is available here: https://cloud.ibm.com/vpc-ext/network/securityGroups.
# Example: SECURITY_GROUP = "ic4sap-securitygroup"

RESOURCE_GROUP = "wes-automation"
# EXISTING Resource group, previously created by the user. The list of available Resource Groups: https://cloud.ibm.com/account/resource-groups
# Example: RESOURCE_GROUP = "wes-automation"

SSH_KEYS = ["r010-8f7dsb994-c17f-4500-af8f-d0cddd0374t3c"]
# List of SSH Keys UUIDs that are allowed to connect via SSH, as root, to the VSI. Can contain one or more IDs. The list of SSH Keys is available here: https://cloud.ibm.com/vpc-ext/compute/sshKeys.
# Example: SSH_KEYS = ["r010-8f72b994-c17f-4500-af8f-d05680374t3c", "r011-8f72v884-c17f-4500-af8f-d05900374t3c"]

ID_RSA_FILE_PATH = "ansible/id_rsa"
# The path to an existing id_rsa private key file, with 0600 permissions. The private key must be in OpenSSH format.
# This private key is used only during the provisioning and it is recommended to be changed after the SAP deployment.
# It must contain the relative or absoute path from your Bastion.
# Examples: "ansible/id_rsa_s4hana_ha" , "~/.ssh/id_rsa_s4hana_ha" , "/root/.ssh/id_rsa".

##########################################################
# File Shares variables:
##########################################################

SHARE_PROFILE = "dp2"
# The Storage Profile for the File Share
# More details on https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-profiles&interface=ui#dp2-profile."

USRSAP_AS1      = "20"
USRSAP_AS2      = "20"
USRSAP_SAPASCS  = "20"
USRSAP_SAPERS   = "20"
USRSAP_SAPMNT   = "20"
USRSAP_SAPSYS   = "20"
USRSAP_TRANS    = "80"
# Default File shares sizes:

##########################################################
# DB VSI variables:
##########################################################

DB_HOSTNAME_1 = "hanadb-1"
# HANA DB VSI HOSTNAME 1 in SAP HANA Cluster. The hostname should be up to 13 characters, as required by SAP
# Default value: "hanadb-1"
# When the default value is used, the virtual hostname will automatically be changed based on <HANA_SID> to "hanadb-<hana_sid>-1"

DB_HOSTNAME_2 = "hanadb-2"
# HANA DB VSI HOSTNAME 2 in SAP HANA Cluster. The hostname should be up to 13 characters, as required by SAP
# Default value: "hanadb-2"
# When the default value is used, the virtual hostname will automatically be changed based on <HANA_SID> to "hanadb-<hana_sid>-2"

DB_PROFILE = "mx2-16x128"
# The instance profile used for the HANA VSI. The list of certified profiles for HANA VSIs: https://cloud.ibm.com/docs/sap?topic=sap-hana-iaas-offerings-profiles-intel-vs-vpc
# Details about all x86 instance profiles: https://cloud.ibm.com/docs/vpc?topic=vpc-profiles).
# For more information about supported DB/OS and IBM Gen 2 Virtual Server Instances (VSI), check [SAP Note 2927211: SAP Applications on IBM Virtual Private Cloud](https://launchpad.support.sap.com/#/notes/2927211) 
# Default value: "mx2-16x128"

DB_IMAGE = "ibm-redhat-8-6-amd64-sap-hana-6"
# OS image for DB VSI. OS images validated for DB VSIs: ibm-redhat-8-6-amd64-sap-hana-6, ibm-redhat-8-4-amd64-sap-hana-10
# The list of available VPC Operating Systems supported by SAP: SAP note '2927211 - SAP Applications on IBM Virtual Private Cloud (VPC) Infrastructure environment' https://launchpad.support.sap.com/#/notes/2927211; The list of all available OS images: https://cloud.ibm.com/docs/vpc?topic=vpc-about-images
# Example: DB_IMAGE = "ibm-redhat-8-4-amd64-sap-hana-9" 

##########################################################
# SAP APP VSI variables:
##########################################################

APP_HOSTNAME_1 = "sapapp-1"
# APP VSI HOSTNAME 1 in SAP APP Cluster. The hostname should be up to 13 characters. 
# Default value: "sapapp-1"
# When the default value is used, the virtual hostname will automatically be changed based on <SAP_SID> to "sapapp-<sap_sid>-1"

APP_HOSTNAME_2 = "sapapp-2"
# APP VSI HOSTNAME 2 in SAP APP Cluster. The hostname should be up to 13 characters. 
# Default value: "sapapp-2"
# When the default value is used, the virtual hostname will automatically be changed based on <SAP_SID> to "sapapp-<sap_sid>-2"

APP_PROFILE = "bx2-4x16"
# The APP VSI profile. Supported profiles: bx2-4x16. The list of available profiles: https://cloud.ibm.com/docs/vpc?topic=vpc-profiles&interface=ui

APP_IMAGE = "ibm-redhat-8-6-amd64-sap-hana-6"
# OS image for SAP APP VSI. OS images validated for APP VSIs: ibm-redhat-8-6-amd64-sap-hana-6, ibm-redhat-8-4-amd64-sap-hana-10.
# The list of available VPC Operating Systems supported by SAP: SAP note '2927211 - SAP Applications on IBM Virtual Private Cloud (VPC) Infrastructure environment' https://launchpad.support.sap.com/#/notes/2927211; The list of all available OS images: https://cloud.ibm.com/docs/vpc?topic=vpc-about-images
# Example: APP_IMAGE = "ibm-redhat-8-4-amd64-sap-hana-9" 

##########################################################
# S/4HANA version
##########################################################

S4HANA_VERSION = "2023"
# The version of S/4HANA. Supported values: 2023, 2022, 2021, 2020.
# Example: S4HANA_VERSION = "2022"

##########################################################
# SAP HANA configuration
##########################################################

HANA_SID = "HDB"
# SAP HANA system ID. Should follow the SAP rules for SID naming.
# Obs. This will be used  also as identification number across different HA name resources. Duplicates are not allowed.
# Example: HANA_SID = "HDB"

HANA_SYSNO = "00"
# SAP HANA instance number. Should follow the SAP rules for instance number naming.
# Example: HANA_SYSNO = "00"

HANA_SYSTEM_USAGE = "custom"
# System usage. Default: custom. Suported values: production, test, development, custom
# Example: HANA_SYSTEM_USAGE = "custom"

HANA_COMPONENTS = "server"
# SAP HANA Components. Default: server. Supported values: all, client, es, ets, lcapps, server, smartda, streaming, rdsync, xs, studio, afl, sca, sop, eml, rme, rtl, trp
# Example: HANA_COMPONENTS = "server"

KIT_SAPHANA_FILE = "/storage/HANADB/SP07/Rev73/51057281.ZIP"
# SAP HANA Installation kit path
# Validated SAP HANA versions for S/4HANA 2023 on Red Hat 8: HANA 2.0 SP 7 Rev 73, kit file: 51057281.ZIP
# Validated SAP HANA versions for S/4HANA 2022, 2021, 2020 on Red Hat 8: HANA 2.0 SP 5 Rev 57, kit file: 51056441.ZIP
# Example for Red Hat 8: KIT_SAPHANA_FILE = "/storage/HANADB/SP07/Rev73/51057281.ZIP"

##########################################################
# SAP system configuration
##########################################################

SAP_SID = "S4A"
# SAP System ID
# Obs. This will be used  also as identification number across different HA name resources. Duplicates are not allowed.

SAP_ASCS_INSTANCE_NUMBER = "00"
# The central ABAP service instance number. Should follow the SAP rules for instance number naming.
# Example: SAP_ASCS_INSTANCE_NUMBER = "00"

SAP_ERS_INSTANCE_NUMBER = "01"
# The enqueue replication server instance number. Should follow the SAP rules for instance number naming.
# Example: SAP_ERS_INSTANCE_NUMBER = "01"

SAP_CI_INSTANCE_NUMBER = "10"
# The primary application server instance number. Should follow the SAP rules for instance number naming.
# Example: SAP_CI_INSTANCE_NUMBER = "10"

SAP_AAS_INSTANCE_NUMBER = "20"
# The additional application server instance number. Should follow the SAP rules for instance number naming.
# Example: SAP_AAS_INSTANCE_NUMBER = "20"

HDB_CONCURRENT_JOBS = "23"
# Number of concurrent jobs used to load and/or extract archives to HANA Host

##########################################################
# SAP S/4HANA APP Kit Paths
##########################################################

KIT_SAPCAR_FILE = "/storage/S4HANA/SAPCAR_1010-70006178.EXE"
KIT_SWPM_FILE = "/storage/S4HANA/SWPM20SP17_0-80003424.SAR"
KIT_SAPEXE_FILE = "/storage/S4HANA/KERNEL/793/SAPEXE_60-70007807.SAR"
KIT_SAPEXEDB_FILE = "/storage/S4HANA/KERNEL/793/SAPEXEDB_60-70007806.SAR"
KIT_IGSEXE_FILE = "/storage/S4HANA/KERNEL/793/igsexe_4-70005417.sar"
KIT_IGSHELPER_FILE = "/storage/S4HANA/igshelper_17-10010245.sar"
KIT_SAPHOSTAGENT_FILE = "/storage/S4HANA/SAPHOSTAGENT61_61-80004822.SAR"
KIT_HDBCLIENT_FILE = "/storage/S4HANA/IMDB_CLIENT20_018_27-80002082.SAR"
KIT_S4HANA_EXPORT = "/storage/S4HANA/2023"

Steps to follow:

For initializing Terraform:

terraform init

For planning phase:

terraform plan --out plan1
# You will be asked for the following sensitive values:
'IBMCLOUD_API_KEY', 'SAP_MAIN_PASSWORD', 'HANA_MAIN_PASSWORD' and 'HA_PASSWORD'.

For apply phase:

terraform apply "plan1"

For destroy:

terraform destroy
# You will be asked for the following sensitive vavalues, as a destroy confirmation phase:
'IBMCLOUD_API_KEY', 'SAP_MAIN_PASSWORD', 'HANA_MAIN_PASSWORD' and 'HA_PASSWORD'.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Automation scripts for the Deployment of SAP S/4HANA High Availability Multi-Zone or Single-Zone using Terraform and Ansible

Description

Contents:

1.1 Installation media

1.2 Prerequisites

1.3 VSI Configuration

1.4 VPC Configuration

1.5 Files description and structure

1.6 General Input variables

S/4HANA 2023

S/4HANA 2022

S/4HANA 2021

S/4HANA 2020

2.1 Executing the deployment of HA SAP S/4HANA installation in GUI (Schematics)

IBM Cloud API Key

Input parameters

Steps to follow:

2.2 Executing the deployment of HA SAP S/4HANA installation in CLI

IBM Cloud API Key

Input parameter file

Steps to follow:

3.1 Related links:

About

Releases 5

Packages

Contributors 2

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 18 Commits
ansible		ansible
files		files
modules		modules
.whitesource		.whitesource
LICENSE		LICENSE
README.md		README.md
SAP_GlobalPartner.png		SAP_GlobalPartner.png
generate-sap-paths.tf		generate-sap-paths.tf
input.auto.tfvars		input.auto.tfvars
integration.tf		integration.tf
main.tf		main.tf
output.tf		output.tf
provider.tf		provider.tf
sch.auto.tfvars		sch.auto.tfvars
variables.tf		variables.tf
versions.tf		versions.tf

License

IBM-Cloud/sap-s4hana-ha

Folders and files

Latest commit

History

Repository files navigation

Automation scripts for the Deployment of SAP S/4HANA High Availability Multi-Zone or Single-Zone using Terraform and Ansible

Description

Contents:

1.1 Installation media

1.2 Prerequisites

1.3 VSI Configuration

1.4 VPC Configuration

1.5 Files description and structure

1.6 General Input variables

S/4HANA 2023

S/4HANA 2022

S/4HANA 2021

S/4HANA 2020

2.1 Executing the deployment of HA SAP S/4HANA installation in GUI (Schematics)

IBM Cloud API Key

Input parameters

Steps to follow:

2.2 Executing the deployment of HA SAP S/4HANA installation in CLI

IBM Cloud API Key

Input parameter file

Steps to follow:

3.1 Related links:

About

Resources

License

Stars

Watchers

Forks

Releases 5

Packages 0

Contributors 2

Languages

Packages