redhat.sap_install Ansible Collection

Description

This Ansible Collection executes various SAP Software installations and configuration tasks for various SAP solutions and deployment scenarios on RHEL for SAP Solutions

• Preparing RHEL 8, RHEL 9 and RHEL 10 systems for the installation of SAP HANA and NetWeaver software
• Installing SAP HANA standalone and scale-out in a non clustered environment
• Configuring SAP HANA scale-up in a 2-node Pacemaker cluster
• Configuring (A)SCS and ERS in a Pacemaker cluster

• Installing SAP software via the SAP Software Provisioning Manager (SWPM)

• NOTE: This version of the collection redhat.sap_install contains the role sap_swpm with a support scope of Fully Supported for the following deployment scenarios: S/4HANA 2021 and later single-host installation on x86_64 and ppc64le: RHEL 8.10, 9.2, 9.4, 9.6 and 10.0.

  All other functionality of this role is currently not supported by Red Hat.

  It might happen that the installation of the ABAP Platform system (SAP NetWeaver) fails because of an incorrectly configured role variable, and that it is not possible for Red Hat to determine the root cause from the SWPM log and trace files. In these cases, Red Hat may ask you to provide the file inifile.params from a successful interactive installation or to use this file as the input parameter file by the role sap_swpm, stored on the managed node in the directory specified in sap_swpm_inifile_directory.

Requirements

Control Nodes

Operating system: - Red Hat Enterprise Linux for SAP Solutions 8.x 9.x 10.x

Python: 3.9 or higher

Ansible-core: 2.14 or higher

Managed Nodes

Operating system: - Red Hat Enterprise Linux for SAP Solutions 8.x 9.x 10.x

NOTE: Operating system needs to have access to required package repositories either directly or via subscription registration.

Python: 3.6 or higher

Installation Instructions

Installation

Install this collection with Ansible Galaxy command:

ansible-galaxy collection install redhat.sap_install

Optionally 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: redhat.sap_install

Upgrade

Installed 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 redhat.sap_install --upgrade

You 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 redhat.sap_install:==1.4.0

See Installing collections for more details on installation methods.

Use Cases

Example Scenarios

• 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.

Ansible Roles

All included roles can be executed independently or as part of ansible.playbooks_for_sap playbooks.

Testing

This Ansible Collection was tested across different Operating Systems, SAP products and scenarios. You can find examples of some of them below.

Operating systems: - Red Hat Enterprise Linux for SAP Solutions 8.x 9.x 10.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

Contributing

For information on how to contribute, please see our contribution guidelines.

Contributors

We welcome contributions to this collection. For a list of all contributors and information on how you can get involved, please see our CONTRIBUTORS document.

Support

You can report any issues using Issues section.

Release Notes and Roadmap

You can find the release notes of this collection in Changelog file

Further Information

Variable Precedence Rules

Please follow Ansible Precedence guidelines on how to pass variables when using this collection.

Getting Started

More information on how to execute Ansible playbooks is in Getting started guide.

License

Apache 2.0