This Ansible Collection executes various SAP Software installations and configuration tasks for various SAP solutions and deployment scenarios on supported Linux operating systems.
Included roles cover range of tasks:
- Preparation of Operating system and SAP installation media before installation
- Installation of SAP Database, either SAP HANA or Oracle Database
- Installation of SAP Products, like SAP S4HANA, SAP BW4HANA, SAP Netweaver, SAP Solution Manager and others.
- Configuration of replication of SAP HANA and High Availability clusters for SAP HANA and SAP Netweaver
Operating system:
- Any operating system with required Python and Ansible versions.
Python: 3.11 or higher
Ansible: 9.9.x
Ansible-core: 2.16.x
NOTE: Ansible 10 and ansible-core 2.17.x are not supported, because of breaking changes requiring higher Python version on managed nodes.
Operating system:
- SUSE Linux Enterprise Server for SAP applications 15 SP5+ (SLE4SAP)
- Red Hat Enterprise Linux for SAP Solutions 8.x 9.x (RHEL4SAP)
NOTE: Operating system needs to have access to required package repositories either directly or via subscription registration.
Python: 3.6 or higher
Install this collection with Ansible Galaxy command:
ansible-galaxy collection install community.sap_installOptionally you can include collection in requirements.yml file and include it together with other collections using: ansible-galaxy collection install -r requirements.yml
Requirements file need to be maintained in following format:
collections:
- name: community.sap_installInstalled Ansible Collection will not be upgraded automatically when Ansible package is upgraded.
To upgrade the collection to the latest available version, run the following command:
ansible-galaxy collection install community.sap_install --upgradeYou can also install a specific version of the collection, when you encounter issues with latest version. Please report these issues in affected Role repository if that happens. Example of downgrading collection to version 1.4.0:
ansible-galaxy collection install community.sap_install:==1.4.0
See Installing collections for more details on installation methods.
- Preparation of Operating system for SAP installation
- Preparation of SAP installation media for SAP installation
- Installation of SAP HANA (including High Availability with replication) or Oracle Database
- Installation of SAP S4HANA or other SAP products
- Configuration of Pacemaker cluster for SAP HANA and SAP Netweaver
More deployment scenarios are available in ansible.playbooks_for_sap repository.
All included roles can be executed independently or as part of ansible.playbooks_for_sap playbooks.
| Name | Summary |
|---|---|
| sap_anydb_install_oracle | Install Oracle DB 19.x for SAP |
| sap_general_preconfigure | Configure general OS settings for SAP software |
| sap_ha_install_hana_hsr | Configure and enable SAP HANA System Replication |
| sap_ha_pacemaker_cluster | Configure Pacemaker cluster for SAP HANA and SAP Netweaver |
| sap_hana_install | Install SAP HANA via HDBLCM |
| sap_hana_preconfigure | Configure OS settings for SAP HANA database server |
| sap_hostagent | Install SAP Host Agent |
| sap_install_media_detect | Detect and extract SAP Software installation media |
| sap_maintain_etc_hosts | Maintain the /etc/hosts file of an SAP software host |
| sap_netweaver_preconfigure | Configure OS settings for SAP NetWeaver application server |
| sap_storage_setup | Configure storage for SAP system (Folder structure, LVM, XFS, NFS) |
| sap_swpm | Install SAP Software via SWPM |
This Ansible Collection was tested across different Operating Systems, SAP products and scenarios. You can find examples of some of them below.
Operating systems:
- SUSE Linux Enterprise Server for SAP applications 15 SP5+ (SLE4SAP)
- Red Hat Enterprise Linux for SAP Solutions 8.x 9.x (RHEL4SAP)
Deployment scenarios:
- All scenarios included in ansible.playbooks_for_sap repository
SAP Products:
- SAP S/4HANA AnyPremise (1809, 1909, 2020, 2021, 2022, 2023) with setup as Standard, Distributed, High Availability and optional Maintenance Planner or Restore System Copy
- SAP Business Suite (ECC) on HANA and SAP Business Suite (ECC) with SAP AnyDB - SAP ASE, SAP MaxDB, IBM Db2, Oracle DB
- SAP BW/4HANA (2021, 2023) with setup as Standard or Scale-Out
- SAP HANA 2.0 (SPS04+) with setup as Scale-Up, Scale-Out, High Availability
- Other SAP installation activities; such as System Rename, System Copy Export, SAP Solution Manager and SAP Web Dispatcher
NOTE: It is not possible to test every Operating System and SAP Product combination with every release. Testing is regularly done for common scenarios: SAP HANA, SAP HANA HA, SAP S4HANA Distributed HA
You can find more information about ways you can contribute at sap-linuxlab website.
You can report any issues using Issues section.
You can find the release notes of this collection in Changelog file
Please follow Ansible Precedence guidelines on how to pass variables when using this collection.
More information on how to execute Ansible playbooks is in Getting started guide.