Installing RHEL 9 for SAP Solutions
Abstract
Making open source more inclusive Copy linkLink copied to clipboard!
Red Hat is committed to replacing problematic language in our code and documentation. We are beginning with these four terms: master, slave, blacklist, and whitelist. Due to the enormity of this endeavor, these changes will be gradually implemented over upcoming releases. For more details on making our language more inclusive, see our CTO Chris Wright’s message.
Providing feedback on Red Hat documentation Copy linkLink copied to clipboard!
We appreciate your feedback on our documentation. Let us know how we can improve it.
Submitting feedback through Jira (account required)
- Make sure you are logged in to the Jira website.
- Provide feedback by clicking on this link.
- Enter a descriptive title in the Summary field.
- Enter your suggestion for improvement in the Description field. Include links to the relevant parts of the documentation.
- If you want to be notified about future updates, please make sure you are assigned as Reporter.
- Click Create at the bottom of the dialogue.
Chapter 1. Introduction Copy linkLink copied to clipboard!
1.1. What is RHEL for SAP Solutions Copy linkLink copied to clipboard!
RHEL for SAP Solutions is a Red Hat subscription that consists of Red Hat Enterprise Linux and additional software repositories and services specifically designed for running SAP HANA and/or SAP ABAP Platform, including SAP S/4HANA, on Red Hat Enterprise Linux.
For more information, refer to Overview of Red Hat Enterprise Linux for SAP Solutions Subscription.
RHEL for SAP Solutions consists of the following repositories:
1.2. Overview of the installation steps Copy linkLink copied to clipboard!
Installing Red Hat Enterprise Linux (RHEL) 9 for SAP Solutions consists of the following steps:
- Install RHEL 9 using one of the standard Red Hat Enterprise Linux 9 installation ISO images.
Install additional packages needed for running SAP software, either
- from another repository source, for example, a Red Hat Satellite system, or
from the RHEL 9 for SAP Solutions image, which contains only a set of additional packages needed for SAP.
NoteThere are also ISO images named Red Hat Enterprise Linux for SAP Solutions, but those only contain the additional software packages required to be installed on top of Red Hat Enterprise Linux. It is not possible to install RHEL for SAP Solutions from these ISO images.
The recommended and easiest way is to install Red Hat Enterprise Linux 9, attach it to a repository source, and then use the RHEL System Roles for SAP for:
- installing additional software packages and
- configuring the system according to the requirements of the SAP software.
Chapter 2. Installing RHEL 9 for SAP Solutions Copy linkLink copied to clipboard!
Before installing RHEL 9 for SAP Solutions, verify that the system fulfills the requirements of the SAP software, e.g., regarding the RAM size, the swap space, and the storage. For RHEL 9 systems running the SAP HANA database, you must use a RHEL 9 minor release for which the E4S repos are available and which is supported by SAP. For RHEL 9 systems running the SAP ABAP Platform, you can use any RHEL 9 minor release.
You can install RHEL 9 in interactive mode or you can perform an unattended installation using Kickstart. This document explains how to perform an interactive installation. Please take a look at the product documentation for Red Hat Enterprise Linux 9 for further guidance on how to install RHEL 9.
Prerequisites
- You have downloaded the installation image for the desired and supported RHEL 9 minor release from the Red Hat Customer Portal (Red Hat Enterprise Linux for x86_64 and Red Hat Enterprise Linux for Power).
- You have verified that the desired hostname meets the requirements for SAP HANA database system or for SAP ABAP Platform systems.
Your server meets the hardware requirements or Infrastructure as a Service (IaaS) configurations.
For bare metal deployment, verify that your server type is mentioned in the SAP Certified and Supported SAP HANA Hardware Directory and that it matches the minimum hardware requirements in the SAP HANA Server Installation and Update Guide.
For certified IaaS Platforms, see the Certified IaaS Platforms on the SAP Certified and Supported SAP HANA Hardware Directory.
Procedure
- Boot your server from the RHEL 9 installation source. For more information on how to boot your server, see Performing a standard RHEL 9 installation.
The following screen appears:
Select the language to be used during the installation process and click Continue. The following screen will appear:
- Under LOCALIZATION, select the desired keyboard layout, language(s) of the installed system, and time and date.
Under SOFTWARE, click Software Selection.
In the Software Selection window, select Server as your Base Environment and click Done.
NoteDo not select any additional software.
Under SYSTEM, click Installation Destination.
In the Installation Destination window, select the storage configuration according to the requirements of the SAP software and according to your needs and click Done.
NoteFor a test system, you can remove the default
/home
file system allocation and use a large root (/
) file system.
- Under SYSTEM, click Network & Host Name, and configure your network connection.
- Under USER SETTINGS, click Root Password and/or User Creation to configure the initial user(s) for your system. In the screens which show up, click Done once you have entered the necessary user information to return to the main installation screen again.
Click Begin Installation. The following screen confirms that the installation is ongoing:
Once RHEL 9 is successfully installed, the screen will look like this:
- Click Reboot System.
Chapter 3. Completing post-installation tasks Copy linkLink copied to clipboard!
This section describes how to complete the post-installation tasks.
3.1. Registering your system Copy linkLink copied to clipboard!
This section explains how to register your RHEL server to Red Hat Satellite.
Different steps apply if your system is registered to the Red Hat Customer Portal or your Cloud provider.
Prerequisites
- You must have a valid Red Hat Enterprise Linux for SAP Solutions subscription so your server has access to required packages via a Red Hat Satellite server, the Red Hat Customer Portal, or your Cloud provider.
You must have the following information provided to you by your Satellite administrator:
- An activation key.
- A string representing the name of the organization.
- A URL for the Katello client package.
- You have system administrator access.
Procedure
Download the Katello client rpm package:
wget https://sat.int.example.com/pub/katello-ca-consumer-latest.noarch.rpm
# wget https://sat.int.example.com/pub/katello-ca-consumer-latest.noarch.rpm
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace the URL with the URL provided by your Satellite administrator.
Install the Katello client rpm package:
dnf install -y katello-ca-consumer-latest.noarch.rpm
# dnf install -y katello-ca-consumer-latest.noarch.rpm
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace the package name with the name of the package you downloaded.
Register your system:
subscription-manager register --org="your-organization-name" \ --activationkey="your-activation-key"
# subscription-manager register --org="your-organization-name" \ --activationkey="your-activation-key"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace
your-organization-name
with the string representing the name of the organization and replaceyour-activation-key
with the activation key. Both are provided by your Satellite administrator.
3.2. Applying the RHEL release lock Copy linkLink copied to clipboard!
For RHEL systems running the SAP HANA database, it is essential that you set the RHEL release lock so that the system remains on the correct RHEL minor release even when doing package updates. Otherwise, the system might be updated to a RHEL release which is not supported by SAP. For RHEL systems not running the SAP HANA database, any RHEL 9 minor release can be used, so applying the RHEL release lock is not necessary in this case.
Prerequisites
- You have system administrator access.
Procedure
Clear the dnf cache:
rm -rf /var/cache/dnf
# rm -rf /var/cache/dnf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Set the release lock:
subscription-manager release --set=9.x
# subscription-manager release --set=9.x
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Replace 9.x with the supported minor release of RHEL 9 (for example 9.4).
3.3. Enabling required repositories Copy linkLink copied to clipboard!
You need to enable certain RHEL repositories to have access to packages required for the SAP HANA installation. For more information on which repositories to enable, see RHEL for SAP Subscriptions and Repositories.
Prerequisites
- You have system administrator access.
Procedure
Disable all repositories and enable the required ones.
- For systems running the SAP HANA database, enable the e4s repos after ensuring that the RHEL release lock is set properly (example for RHEL 9.4):
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
-
If you intend to use the system for the SAP HANA database only, enabling the
sap-netweaver-e4s-rpms
repository is not required. - For systems running the SAP Application Platform only, if you do not want to restrict your system to a specific RHEL minor release when updating packages, enable the normal repos. In this case, verify that no RHEL release lock is set.
Chapter 4. RHEL System Roles for SAP Copy linkLink copied to clipboard!
The RHEL System Roles for SAP provide a quick, easy, and consistent method for preparing your local system or any number of remote systems according to applicable SAP notes for SAP software. They include the Ansible roles sap_general_preconfigure
, sap_netweaver_preconfigure
, and sap_hana_preconfigure
and require an Ansible execution system (e.g., Ansible Automation Platform, Ansible Core).
4.1. Installing Ansible Core Copy linkLink copied to clipboard!
Ansible Core is available in the RHEL 9 AppStream repository.
If you already have an Ansible Automation Platform or Ansible Core package installed, you can skip this step and proceed to Installing RHEL System Roles for SAP.
Prerequisites
- You have system administrator access.
Procedure
Install the ansible-core package:
dnf install ansible-core
# dnf install ansible-core
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.2. Installing RHEL System Roles for SAP Copy linkLink copied to clipboard!
RHEL System Roles for SAP is available in the RHEL for SAP Solutions r epository. It requires certain functionality delivered in the RHEL System Roles, which are available in the AppStream repository.
Prerequisites
- You have system administrator access.
- You have installed the Ansible Core package or Ansible Automation Platform.
Procedure
Install RHEL System Roles for SAP and RHEL System Roles:
dnf install rhel-system-roles-sap rhel-system-roles
# dnf install rhel-system-roles-sap rhel-system-roles
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.3. System configuration with RHEL System Roles for SAP Copy linkLink copied to clipboard!
4.3.1. Preparing a local system Copy linkLink copied to clipboard!
If the Ansible Engine is installed on the same system on which you want to install the SAP software, perform the steps outlined in this procedure to configure your local managed node.
Prerequisites
- You have system administrator access.
Procedure
- Make a backup of the system if you would like to preserve the original configuration of the server.
Create a file named
sap.yml
with the following content:Copy to Clipboard Copied! Toggle word wrap Toggle overflow ImportantThe correct indentation and the use of spaces instead of tabs is essential for YAML files.
Note-
The line
sap_general_preconfigure_max_hostname_length: 64
is only required if your hostname (hostname -s
) is longer than 13 characters and if you are not using this system for an SAP ABAP Platform instance. Without this line, the rolesap_general_preconfigure
will fail its hostname check because a hostname with more than 13 characters is not allowed for an SAP ABAP Platform instance as per SAP note 611361. -
The line
sap_netweaver_preconfigure
is used to perform specific installation and configuration steps for an SAP ABAP Platform. It can be removed or commented out for an SAP HANA database only system. -
The line
sap_hana_preconfigure
is used to perform specific installation and configuration steps for an SAP HANA database. It can be removed or commented out for an SAP ABAP Platform only system.
-
The line
Run the
sap.yml
Ansible playbook:ansible-playbook sap.yml -e 'ansible_python_interpreter=/usr/libexec/platform-python'
# ansible-playbook sap.yml -e 'ansible_python_interpreter=/usr/libexec/platform-python'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This will configure this system according to the applicable SAP notes for SAP ABAP Platform and/or SAP HANA on RHEL 9.
After the ansible-playbook command has finished successfully, reboot the system:
reboot
# reboot
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.3.2. Preparing one or more remote systems Copy linkLink copied to clipboard!
If the Ansible Engine is installed on the same system on which you want to install the SAP software, perform the steps outlined in this procedure to configure your local managed node.
Prerequisites
- You have system administrator access.
Procedure
- Make a backup of the remote systems if you would like to preserve the original configuration of the server.
Create an inventory file or modify file
/etc/ansible/hosts
to contain the name of a group of hosts and each system which you intend to configure (=managed node) in a separate line (example for three hosts in a host group namedsap_hosts
):[sap_hosts] host01 host02 host03
[sap_hosts] host01 host02 host03
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Verify that you can log in to all three hosts using ssh without a password. Example:
ssh host01 uname -a ssh host02 hostname ssh host03 echo test
# ssh host01 uname -a # ssh host02 hostname # ssh host03 echo test
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Create a YAML file named sap.yml with the following content:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Note-
The line
sap_general_preconfigure_max_hostname_length: 64
is only required if your hostname (hostname -s
) is longer than 13 characters and if you are not using this system for an SAP ABAP Platform instance. Without this line, the rolesap_general_preconfigure
will fail its hostname check because a hostname with more than 13 characters is not allowed for an SAP ABAP Platform instance as per SAP note 611361. -
The line
sap_netweaver_preconfigure
is used to perform specific installation and configuration steps for an SAP ABAP Platform. It can be removed or commented out for an SAP HANA database only system. -
The line
sap_hana_preconfigure
is used to perform specific installation and configuration steps for an SAP HANA database. It can be removed or commented out for an SAP ABAP Platform only system.
-
The line
Run the
sap.yml
Ansible playbook:ansible-playbook sap.yml
# ansible-playbook sap.yml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This will configure all systems that are part of host group
sap_hosts
according to the applicable SAP notes for SAP ABAP Platform and/or SAP HANA on RHEL 9. Finally, if necessary, the systems are rebooted.