Terraform-Scripts

Die Terraform-Skripte für die Bereitstellung sind enthalten:

• 1 Platzierungsgruppe, die alle 4 an dieser Lösung beteiligten VMs umfasst.
• 4 VSI in einer bestehenden VPC mit Subnetz- und Sicherheitsgruppenkonfigurationen. Der Umfang der VSIs: 2 für die HANA-Datenbank-Cluster-Instanz und 2 für den Anwendungscluster SAP.
• Konfiguration von 3 Application Load Balancern wie HANA DB und SAP ASCS/ERS.
• Konfiguration von 1 VPC-DNS-Dienst, der verwendet wird, um den ALB-FQDN auf die virtuellen Hostnamen SAP ASCS/ERS und HANA abzubilden.
• Konfigurieren von 7 Dateifreigaben für VPC.

Die Ansible Skripte, die für die Bereitstellung enthalten sind, sind:

• Installation und Konfiguration der Betriebssystemanforderungen für SAP Anwendungen.
• Installation der Cluster-Komponenten
• Ansible skripte für die Konfiguration von SAP Anwendungsclustern und SAP HANA Clusterkonfiguration.
• HANA-Installation
• HANA DB-Sicherung
• Konfiguration der HANA-Systemreplik
• Installation von ASCS- und ERS-Instanzen
• DB-Last
• Installation von primären und zusätzlichen Anwendungsservern

Für die CLI-Bereitstellung wird Ansible von Terraform gestartet und beide müssen auf demselben Host (Bastion-Server) verfügbar sein.

Übersicht über die Terraform-Bereitstellung

Die Automatisierungsskripte aus dem GitHub Repository können durch Ausführen der Terraform-Skripte in der CLI vom Bastion-Server (Deployment-Server) aus ausgeführt werden.

Bearbeiten Sie die Eingabeparameterdatei input.auto.tfvars, und passen Sie die Variablen an Ihre Lösung an:

• VPC - Ein vorhandener VPC-Name
• REGION - Region für die VSI
• DOMAIN_NAME - Private Domain, die von der Außenwelt nicht erreicht werden kann
• ZONE_1- Verfügbarkeitszone für DB_HOSTNAME_1 und APP_HOSTNAME_1 VSI
• ZONE_2- Verfügbarkeitszone für DB_HOSTNAME_2 und APP_HOSTNAME_2VSIs
• SECURITY_GROUP - Vorhandene Sicherheitsgruppe, die zuvor vom Benutzer in derselben VPC erstellt wurde.
• SUBNET_1- Der Name eines bestehenden Subnetzes in derselben VPC, ZONE_1, in dem DB_HOSTNAME_1 und APP_HOSTNAME_1 VSI erstellt werden.
• SUBNET_2- Der Name eines bestehenden Subnetzes in derselben VPC, ZONE_2, in dem DB_HOSTNAME_2 und APP_HOSTNAME_2 VSI erstellt werden.
• RESOURCE_GROUP - Vorhandene Ressourcengruppe, die zuvor vom Benutzer erstellt wurde.
• SSH_KEYS - Liste der SSH-Schlüssel-UUIDs, die für SSH als root zu den VSI zugelassen sind.
• ID_RSA_FILE_PATH - id_rsa Dateipfad des privaten Schlüssels im Format OpenSSH mit 0600 Berechtigungen
• APP_HOSTNAME_1/ APP_HOSTNAME_2/DB_HOSTNAME_1/ DB_HOSTNAME_2- Geben Sie einen Hostnamen mit bis zu 12 Zeichen ein. Weitere Informationen finden Sie in der Readme-Datei.
• DB_PROFILE/APP_PROFILE - Das für den HANA/APP VSI verwendete Instanzprofil
• DB_IMAGE/APP_IMAGE - Betriebssystem-Image für DB/APP VSI

Schematics einsatzübersicht

Schematics benutzeroberfläche auf der Website IBM Cloud verwendet wird. Geben Sie das Repository GitHub für SAP NetWeaver (ABAP){: external} auf der HANA-Datenbank Hochverfügbarkeit in einer oder mehreren Zonen Schematics ein.

Wenn Sie die Skripte über die Schnittstelle Schematics ausführen, können Sie:

• Geben Sie Informationen zum Arbeitsbereich ein.
• Geben Sie den GitHub Pfad für die verwendeten Terraform-Skripte ein.
• Ändern Sie die Parameter in der Schnittstelle Schematics.

Bereitstellung von SAP HA NetWeaver 7.5 unter Verwendung von Terraform mit dem Bastion Server CLI

Führen Sie diese Schritte aus, um das IBM Cloud Provider Plug-in zu konfigurieren und Terraform zu verwenden, um SAP HA SZ oder MZ S/4HANA auf Ihrer bestehenden VPC zu installieren. Die Bearbeitung der Skripte kann bis zu 4 Stunden in Anspruch nehmen. Die unterstützten Versionen für SAP NetWeaver (ABAP) mit HANA HA SZ und MZ ist RHEL. Weitere Informationen finden Sie in der Readme-Datei zu den empfohlenen Versionen der Kits.

1. Greifen Sie auf die Befehlszeilenschnittstelle des Bastionsservers zu.

2. Klonen Sie das Lösungs-Repository von https://github.com/IBM-Cloud/sap-nwhana-ha und cd in den Ordner sap-nwhana-ha.

   git clone https://github.com/IBM-Cloud/sap-nwhana-ha.git
   
   cd sap-nwhana-ha
   
   

3. Geben Sie Ihre VPC an. Ändern Sie die Datei input.auto.tfvars, um die Informationen für die vorhandene VPC, Ihre Zone, Ihre VPC und die Komponentennamen, das Profil und das Image anzugeben. Sie benötigen Ihre 40-stellige SSH-Schlüssel-ID für diese Datei. Der zweite SSH-Schlüssel ist optional. Weitere Optionen für das Profil finden Sie unter Instanzprofile. Weitere Optionen für Bilder finden Sie unter Bilder. Eine Beschreibung der Variablen finden Sie in der Readme-Datei.

   ##########################################################
   # General VPC variables:
   ##########################################################
   
   REGION = ""
   # 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 = ""
   # 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/infrastructure/network/vpcs.
   # Example: VPC = "ic4sap"
   
   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
   # Example: ZONE = "eu-de-1"
   
   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/infrastructure/network/subnets
   # Example: SUBNET = "ic4sap-subnet_1"
   
   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.
   # 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 = ""
   # 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/infrastructure/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 = ""
   # 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/infrastructure/network/securityGroups.
   # Example: SECURITY_GROUP = "ic4sap-securitygroup"
   
   RESOURCE_GROUP = ""
   # 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 = [""]
   # 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/infrastructure/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){: external}
   # 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-10"
   
   ##########################################################
   # 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-10"
   

4. Passen Sie Ihre SAP-Systemkonfiguration an. Bearbeiten Sie in derselben Datei input.auto.tfvars die Systemkonfigurationsvariablen SAP, die an die automatische Bereitstellung Ansible übergeben werden. Eine Beschreibung der Variablen finden Sie in der Readme-Datei.

   ##########################################################
   # 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/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/51056441.ZIP"
   
   ##########################################################
   # SAP system configuration
   ##########################################################
   
   SAP_SID= "NWD"
   # 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 Kit example Paths (storage from SAP Bastion server VSI instance)
   ##########################################################
   
   KIT_SAPCAR_FILE = "/storage/NW75SYB/SAPCAR_1010-70006178.EXE"
   KIT_SWPM_FILE =  "/storage/NW75SYB/SWPM10SP38_0-20009701.SAR"
   KIT_SAPHOSTAGENT_FILE = "/storage/NW75SYB/SAPHOSTAGENT61_61-80004822.SAR"
   KIT_SAPEXE_FILE = "/storage/NW75SYB/KERNEL/754UC/SAPEXE_200-80007612.SAR"
   KIT_SAPEXEDB_FILE = "/storage/NW75SYB/KERNEL/754UC/SAPEXEDB_200-80007655.SAR"
   KIT_IGSEXE_FILE = "/storage/NW75SYB/KERNEL/754UC/igsexe_2-80007786.sar"
   KIT_IGSHELPER_FILE = "/storage/NW75SYB/igshelper_17-10010245.sar"
   KIT_ASE_FILE = "/storage/NW75SYB/51056521_1_16_0_04_04.ZIP"
   KIT_EXPORT_DIR = "/storage/NW75SYB/EXP"
   

   Ansible dekomprimiert die übrigen SAP-Kitdateien. Weitere Informationen finden Sie in der Readme-Datei.

5. Terraform-Befehlszeilenschnittstelle initialisieren.

   terraform init
   

6. Erstellen Sie einen Terraform-Ausführungsplan. Der Terraform-Ausführungsplan fasst alle Aktionen zusammen, die ausgeführt werden müssen, um die virtuelle private Cloud-Serviceinstanz in Ihrem Konto zu erstellen.

   terraform plan --out plan1
   

   Sie werden nach den folgenden sensiblen Variablen gefragt: 'IBMCLOUD_API_KEY', 'SAP_MAIN_PASSWORD' HANA_MAIN_PASSWORD, and 'HA_PASSWORD'.

   Das Hauptpasswort SAP muss 10 - 14 Zeichen lang sein und mindestens eine Ziffer (0-9) enthalten. Es darf nur die folgenden Zeichen enthalten: a–z, A–Z, 0–9, @, #, $, . Dieses Kennwort darf nicht ! enthalten. Es darf nicht mit einer Ziffer oder einem Unterstreichungszeichen () beginnen.

7. Stellen Sie sicher, dass der Plan alle Ressourcen anzeigt, die Sie erstellen möchten, und dass die Namen und Werte korrekt sind. Wenn der Plan angepasst werden muss, bearbeiten Sie die Datei input.auto.tfvars, um die Ressourcen zu korrigieren, und führen Sie terraform plan erneut aus.

8. Erstellen Sie die Ressourcen IBM Cloud für das System SAP NetWeaver 7.5 HA und installieren Sie das System SAP.

   terraform apply "plan1"
   

   Die virtuelle private Cloud und Komponenten werden erstellt und es wird eine Ausgabe ähnlich der terraform plan-Ausgabe angezeigt.

   terraform destroy
   

   In der Bestätigungsphase werden Sie nach den folgenden sensiblen Variablen gefragt: 'IBMCLOUD_API_KEY', 'SAP_MAIN_PASSWORD' HANA_MAIN_PASSWORD, and 'HA_PASSWORD'.

Bereitstellung von SAP NetWeaver 7.5 on HANA High Availability auf Single Zone oder Multi Zone mit der Schnittstelle Schematics

Führen Sie die folgenden Schritte aus, um SAP NetWeaver 7.5 on HANA High Availability on Single Zone oder Multi Zone in Ihrer bestehenden VPC über die Schnittstelle Schematics zu konfigurieren. Die Bearbeitung der Skripte kann 2 bis 3 Stunden in Anspruch nehmen. Weitere Informationen finden Sie in der Readme-Datei zu den empfohlenen Versionen der Kits.

1. Wählen Sie im Menü IBM Cloud Schematics.

2. Klicken Sie auf Arbeitsbereich erstellen.

3. Gehen Sie auf der Seite Vorlage angeben wie folgt vor:

   • Geben Sie das Repository GitHub URL ein, das den Code Schematics für dieses Angebot enthält.
   • Wählen Sie Terraform-Version aus.
   • Klicken Sie auf Weiter.

4. Gehen Sie auf der Seite Arbeitsbereichsdetails wie folgt vor:

   • Geben Sie einen Namen für den Arbeitsbereich ein.
   • Wählen Sie eine Ressourcengruppe aus.
   • Wählen Sie eine Position für Ihren Arbeitsbereich aus. Die Arbeitsbereichsposition muss nicht mit der Ressourcenposition übereinstimmen.
   • Wählen Sie Weiter aus.

5. Wählen Sie Erstellen aus, um Ihren Arbeitsbereich zu erstellen.

6. Überprüfen Sie auf der Seite Einstellungen des Arbeitsbereichs im Abschnitt Eingabevariablen die Standard-Eingabevariablen und geben Sie Werte ein, die Ihrer Lösung entsprechen.

   Eine detailliertere Beschreibung der einzelnen Parameter finden Sie in der Readme-Datei des GitHub Repo, Kapitel "Input parameter file". Stellen Sie außerdem sicher, dass die Parameter, die sensible Informationen wie Kennwörter, API und private ssh-Schlüssel enthalten, als "sensibel" gekennzeichnet sind. Diese Parameter sind in der Readme-Datei unter "Eingabeparameterdatei" als "sensibel" gekennzeichnet.

   Speichern Sie jeden Parameter, den Sie ändern.

7. Klicken Sie auf der Seite "Einstellungen" des Arbeitsbereichs auf Plan generieren. Warten Sie, bis der Plan ausgeführt wurde.

8. Klicken Sie auf Protokoll anzeigen, um die Protokolldateien des Terraform-Ausführungsplans zu überprüfen.

9. Wenden Sie die Terraform-Vorlage durch Klicken auf Plan anwenden an.

10. Überprüfen Sie die Protokolldatei, um sicherzustellen, dass während des Bereitstellungs-, Änderungs- oder Löschprozesses keine Fehler aufgetreten sind.

Nächste Schritte

Wenn Sie die Installation von SAP HA NetWeaver 7.5 entfernen müssen, gehen Sie zu Ihrem Projektordner und führen Sie terraform destroy aus. Der Befehl terraform destroy entfernt die VPC in diesem Szenario nicht, da die VPC nicht mit demselben Terraform-Skript erstellt wurde.