Search

Chapter 1. Overview

download PDF

Red Hat Enterprise Linux (RHEL) 7 RHEA-2019:3190 introduced RHEL System Roles for SAP to assist with remotely or locally configuring a RHEL system for the installation of SAP HANA or SAP NetWeaver software. RHEL System Roles for SAP development is based on the SAP LinuxLab upstream project.

RHEL System Roles is a collection of roles executed by Ansible to assist administrators with RHEL system configuration. These roles are provided in the RHEL AppStream repository. In contrast, RHEL System Roles for SAP is provided in the RHEL for SAP Solutions subscription.

The Red Hat Enterprise Linux for SAP Solution subscription provides support for RHEL System Roles for SAP with Ansible Core. However, if you require full support for Ansible Core, a separate subscription is necessary. Additional information is available at Red Hat Enterprise Linux (RHEL) System Roles.

The following RHEL System Roles for SAP are fully supported on control nodes running RHEL 8.4 and later:

  • sap_general_preconfigure
  • sap_netweaver_preconfigure
  • sap_hana_preconfigure
  • sap_hana_install

The following RHEL System Roles for SAP are supported as Technology Preview on control nodes running RHEL 8.4 and later:

  • sap_ha_install_hana_hsr
  • sap_ha_pacemaker_cluster
  • sap_swpm (*)

The RHEL System Roles for SAP, just like the RHEL System Roles, are installed and run from a central node referred to as the control node (which can be Ansible Automation controller, Red Hat Satellite, or a RHEL 9 or RHEL 8 host). The control node connects to the local host and/or to one or more remote hosts (called managed nodes in the context of Ansible), and performs installation and configuration steps on them. It is recommended that you use the latest major release of RHEL on the control node (RHEL 8) and use the latest version of the roles either from the rhel-system-roles-sap RPM or from Red Hat Automation Hub. The RHEL System Roles for SAP and Ansible packages do not need to be installed on the systems that are being managed/configured.

This document describes how to install and use RHEL package rhel-system-roles-sap version 3.3.0 (*) or Automation Hub collection redhat.sap_install version 1.2.1, which consists of the following roles.

Note

Package rhel-system-roles-sap version 3.3.0 does not contain the role sap_swpm. This role is planned to be released in the next version of package rhel-system-roles-sap.

Purpose

Role NameDescription

sap_general_preconfigure

Perform installation and configuration steps common to SAP NetWeaver and SAP HANA

sap_netweaver_preconfigure

Perform additional installation and configuration steps for SAP NetWeaver

sap_hana_preconfigure

Perform additional installation and configuration for SAP HANA

sap_hana_install

Perform a SAP HANA scale-up or scale-out installation

sap_ha_install_hana_hsr

Set up SAP HANA System Replication on two nodes

sap_ha_pacemaker_cluster

Install Pacemaker and configure the cluster and SAP cluster resources

sap_swpm

Install SAP Software via SWPM

Support Status

Role NameSupport StatusRemote Host ManagementControl Node

sap_general_preconfigure

Fully supported

RHEL 7.6 and later, RHEL 8, RHEL 9

RHEL 8, RHEL 9

sap_netweaver_preconfigure

Fully supported

RHEL 7.6 and later, RHEL 8, RHEL 9

RHEL 8, RHEL 9

sap_hana_preconfigure

Fully supported

RHEL 7.6 and later, RHEL 8, RHEL 9

RHEL 8, RHEL 9

sap_hana_install

Fully supported

RHEL 7.6 and later, RHEL 8, RHEL 9

RHEL 8, RHEL 9

sap_ha_install_hana_hsr

Technology Preview

RHEL 8, RHEL 9

RHEL 8, RHEL 9

sap_ha_pacemaker_cluster

Technology Preview

RHEL 8, RHEL 9

RHEL 8, RHEL 9

sap_swpm (*)

Technology Preview for certain functionality, unsupported for all other functionality

RHEL 8, RHEL 9

RHEL 8, RHEL 9

Note
  • * This version of the RHEL System Roles for SAP contains the role sap_swpm with a support scope of Technology Preview for the role’s default mode only and only for the following deployment scenarios: S/4HANA 2021 and S/4HANA 2022 single-host installation on x86_64: RHEL 8.4, 8.6, 9.0 and ppc64le: RHEL 8.4 and 8.6.

    All other functionality of the role sap_swpm is not supported.

Platforms
See the table below for the supported hardware/virtualization/cloud platforms of the managed node:

Hardware platformBare Metal/Virtualization/ Cloud platformSupport Status

x86_64

bare metal, Red Hat Virtualization/libvirt, VMware ESX, Red Hat Certified Cloud and Service Providers

supported as per Support Status in the previous table

ppc64le

PowerVM LPARs

supported as per Support Status in the previous table

s390x

zVM guest

fully supported: sap_general_preconfigure, sap_netweaver_preconfigure

Directories

Installation MethodRoles; Documentation

RHEL package rhel-system-roles-sap

/usr/share/ansible/roles/<role>; /usr/share/doc/rhel-system-roles-sap/<role>

Automation Hub collection redhat.sap_install

~/.ansible/collections/ansible_collection/redhat/sap_install/<role>; ~/.ansible/collections/ansible_collection/redhat/sap_install/<role>/README.md

Note
  • The roles are designed to be used right after the initial installation of a managed node. If you want to run these roles against an SAP or other production system, run them in assertion mode first so you can detect which settings deviate from SAP’s recommendations as per applicable SAP notes. When run in normal mode, the roles will enforce the SAP recommended configuration on the managed node(s). Unusual system configuration settings might in rare cases still lead to unintended changes by the role. Before using the roles in normal mode on production systems, it is strongly recommended to backup the system and test the roles on a test and QA system first.
  • Before applying the roles on a managed node, verify that the RHEL release on the managed node is supported by the SAP software version that you are planning to install. The role sap_hana_preconfigure will fail if a RHEL minor version is used for which no SAP HANA validation exists (can be overridden).
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.

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.

© 2024 Red Hat, Inc.