Chapter 5. RHEL System Roles for SAP


RHEL System Roles for SAP is a set of roles executable by Ansible that can assist you with configuring your local or remote hosts (managed nodes) for the installation of SAP HANA.

5.1. Installing Ansible Engine

RHEL subscriptions provide support for RHEL System Roles with Ansible Engine, which is available in the Ansible Engine repository.

Note that if you already have an Ansible Tower or Ansible Engine, you can skip this step and proceed to Installing RHEL System Roles for SAP.

Prerequisites

  • root access

Procedure

  1. Enable the Ansible repository:

    # subscription-manager repos \
    --enable=ansible-2.9-for-rhel-8-$(uname -m)-rpms
    Copy to Clipboard Toggle word wrap
  2. Install the Ansible Engine:

    # yum install ansible
    Copy to Clipboard Toggle word wrap

5.2. Installing RHEL System Roles for SAP

RHEL System Roles for SAP include sap_general_preconfigure, sap_netweaver_preconfigure, and sap_hana_preconfigure. These roles can be used to configure the local or remote managed nodes.

Prerequisites

  • root access
  • You have installed Ansible Engine or Ansible Tower

    For more information on how to Install Ansible Engine, see Installing Ansible Engine.

Procedure

  • Install RHEL System Roles for SAP:

    # yum install rhel-system-roles-sap
    Copy to Clipboard Toggle word wrap

The RHEL System Roles for SAP provide a quick, easy, and consistent method for performing the configuration of your server according to applicable SAP notes for SAP HANA.

5.3.1. Configuring a local managed node

If the Ansible Engine is installed on same host on which you want to install SAP HANA, perform the steps outlined in this procedure to configure your local managed node.

Prerequisites

  • root access

Procedure

  1. Create a file named sap-hana.yml with the following content:

    ---
    - hosts: localhost
      vars:
        ansible_connection: local
        sap_preconfigure_fail_if_reboot_required: no
        sap_hana_preconfigure_fail_if_reboot_required: no
        sap_hana_preconfigure_update: yes
      roles:
        - role: sap_general_preconfigure
        - role: sap_hana_preconfigure
    Copy to Clipboard Toggle word wrap
    Important

    The indentation and the use of spaces instead of tabs is essential for YAML files.

  2. Run the sap-hana.yml Ansible playbook:

    # ansible-playbook sap-hana.yml
    Copy to Clipboard Toggle word wrap

    This configures the local managed node according to the applicable SAP notes for SAP HANA.

  3. Reboot the server.

5.3.2. Configuring a remote managed node

If you have a separate Ansible Engine Control Node, you can configure one or more managed nodes in an automated way.

Prerequisites

Procedure

  1. Create or modify the file /etc/ansible/hosts with new host names to be configured:

    host01
    host02
    Copy to Clipboard Toggle word wrap

    Replace host01 and host02 with the names of your managed nodes. Each managed node name must be on a separate line.

  2. Create a file named sap-hana.yml with the following content:

    - hosts: all
      vars:
        sap_preconfigure_fail_if_reboot_required: no
        sap_hana_preconfigure_fail_if_reboot_required: no
        sap_hana_preconfigure_update: yes
      roles:
        - role: sap_general_preconfigure
        - role: sap_hana_preconfigure
    Copy to Clipboard Toggle word wrap
    Important

    The indentation and the use of spaces instead of tabs is essential for YAML files.

  3. Run the sap-hana.yml ansible playbook:

    # ansible-playbook -l host01,host02 sap-hana.yml
    Copy to Clipboard Toggle word wrap

    Replace host01 and host02 with the names of your managed nodes.

    This configures the remote host01 and host02 according to the applicable SAP notes for SAP HANA.

  4. Reboot the servers host01 and host02.
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top