Installing RHEL 10 for SAP Solutions
Performing a local, interactive installation of RHEL 10 for SAP Solutions
Abstract
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.
- Click on this link to provide feedback.
- 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.
- 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.
Below is the information about RHEL for SAP Solutions Subscription:
Red Hat Enterprise Linux
- Red Hat support for SAP customers
- 4 years of updates for important RHEL packages
- Additional Red Hat repositories for SAP HANA and SAP ABAP Platform
For more information, refer to Introduction to Red Hat Enterprise Linux for SAP Solutions.
RHEL for SAP Solutions consists of the following repositories:
RHEL repositories:
- BaseOS
- AppStream
Red Hat Repositories for SAP:
- SAP Solutions
- SAP NetWeaver
- High Availability
1.2. Overview of the installation steps Copy linkLink copied to clipboard!
Installing Red Hat Enterprise Linux (RHEL) 10 for SAP Solutions consists of the following steps:
- Install RHEL 10 using one of the standard Red Hat Enterprise Linux 10 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 10 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 10, 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 10 for SAP Solutions Copy linkLink copied to clipboard!
Before installing RHEL 10 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 10 systems running the SAP HANA database, you must use a RHEL 10 minor release for which the E4S repos are available and which SAP supports. For RHEL 10 systems running the SAP ABAP Platform, you can use any RHEL 10 minor release after SAP has validated SAP ABAP Platform for RHEL 10.
You can install RHEL 10 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 10 for further guidance on how to install RHEL 10.
Prerequisites
- You have downloaded the installation image for the desired and supported RHEL 10 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 10 installation source. For more information on how to boot your server, see Booting the installation media (USB or DVD) or Booting the installation from a network Booting the installation media from a network using HTTP or PXE.
In the initial screen, WELCOME TO RED HAT ENTERPRISE LINUX 10.0, select the language which you would like to use during the installation process. In this document, we assume you select English (United States). Press the Continue button in the lower right corner to proceed to the next screen, INSTALLATION SUMMARY, where you can perform specific configuration changes using additional screens (e.g. for configuring the disk layout). After confirming any change using the Done button, the INSTALLATION SUMMARY screen is displayed again.
- Under LOCALIZATION, click Keyboard, Language Support, and/or Time & Date for changing any of these settings. For an SAP system, English (United States) must always be present (you can also install additional languages).
- Under SOFTWARE, click Software Selection. Select Server as your Base Environment section. Do not select anything in the Additional software for Selected Environment section. Click Done.
- Under SYSTEM, select Installation Destination. Select the storage configuration according to the requirements of the SAP software and according to your needs. For more information on the configuration options, refer to Configuring the storage devices and Configuring manual partitioning. Click Done when finished with these changes to return to the INSTALLATION SUMMARY screen..
- Under SYSTEM again, click Network & Host Name and if necessary, configure your network connection. Click Done.
- Under USER SETTINGS, click Root Account 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 confirm these settings.
- Click Begin Installation in the INSTALLATION SUMMARY screen, after performing all configuration settings. The next screen displays the installation progress. After some time, the button Reboot System, which is grayed out during the installation, changes to a clickable button, and the Quit button disappears.
- Click Reboot System.
Chapter 3. 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
- Your system has been installed and rebooted as explained in the previous chapter.
- 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.rpmReplace the URL with the URL provided by your Satellite administrator.
Install the Katello client rpm package:
# dnf install -y katello-ca-consumer-latest.noarch.rpmReplace 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"Replace
your-organization-namewith the string representing the name of the organization and replaceyour-activation-keywith 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 (after SAP validates SAP HANA for the RHEL minor release), 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 that SAP does not support. For RHEL systems not running the SAP HANA database, any RHEL 10 minor release can be used for running the SAP ABAP Platform (after SAP validates it), 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/dnfSet the release lock:
# subscription-manager release --set=10.xReplace 10.x with the supported minor release of RHEL 10 (for example 10.0).
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.
- Enable the e4s repos for systems running the SAP HANA database, after ensuring that the RHEL release lock is set properly (example for RHEL 10.0):
# subscription-manager release Release: 10.0 # subscription-manager repos \ --disable=\* \ --enable="rhel-10-for-$(uname -m)-baseos-e4s-rpms" \ --enable="rhel-10-for-$(uname -m)-appstream-e4s-rpms" \ --enable="rhel-10-for-$(uname -m)-sap-solutions-e4s-rpms" \ --enable="rhel-10-for-$(uname -m)-sap-netweaver-e4s-rpms"
-
If you intend to use the system for the SAP HANA database only, you do not have to enable
sap-netweaver-e4s-rpmsrepository. - For systems running the SAP ABAP 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. The Ansible roles sap_general_preconfigure, sap_netweaver_preconfigure and sap_hana_preconfigure are used for this purpose.
In this document, the configuration of the local system is described. For configuring any number of remote systems using the RHEL System Roles for SAP, including from an Ansible Automation Platform host, refer to Red Hat Enterprise Linux System Roles for SAP.
4.1. Installing RHEL System Roles for SAP Copy linkLink copied to clipboard!
RHEL System Roles for SAP is available in the RHEL for SAP Solutions repository. It requires certain functionality delivered in the RHEL System Roles, which are available in the AppStream repository.
Prerequisites
- You have system administrator access.
Procedure
Install RHEL System Roles for SAP (this will install certain dependent packages, e.g.
ansible-core,rhel-system-rolesand certain requiredpython3packages):# dnf install rhel-system-roles-sap
4.2. Configuring the system for SAP HANA with RHEL System Roles for SAP Copy linkLink copied to clipboard!
For preparing the system, you must first create a yml file with certain parameter settings. Then, use the ansible-playbook command to configure the system.
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.
-
Configure your name resolution and
/etc/hostssettings according to your desired configuration. The RHEL System Roles for SAP can also be used to maintain your/etc/hostsfile (using the parameterssap_domainandsap_general_preconfigure_modify_etc_hosts) but for simplicity, we assume that your name resolution and the content of/etc/hostsare configured already. - Ensure that your release lock is set according to your needs and that you have enabled the desired repositories. The RHEL System Roles for SAP can also be used to set the release lock and enable the repos but for simplicity, we assume that these configuration settings are already done.
Create a file named
sap-vars.ymlwith the content in the code block below. It updates your system to the latest patch level. If this is not desired, setsap_general_preconfigure_updateandsap_hana_preconfigure_updatetofalse, comment out these lines by prepending them with#, or remove these two lines:--- sap_general_preconfigure_update: true sap_general_preconfigure_fail_if_reboot_required: false sap_netweaver_preconfigure_fail_if_reboot_required: false sap_hana_preconfigure_update: true sap_hana_preconfigure_fail_if_reboot_required: falseRun the following command:
# ansible-playbook redhat.sap_install.sap_hana_preconfigure_exec.yml -e @sap-vars.ymlThis configures this system according to the applicable SAP notes for SAP HANA on RHEL 10.
After the ansible-playbook command has finished, reboot the system:
# reboot
4.3. Configuring the system for SAP ABAP Platform with RHEL System Roles for SAP Copy linkLink copied to clipboard!
For configuring the system for SAP ABAP Platform, you must create a second yml file in addition to the file sap-vars.yml mentioned above and then, use the ansible-playbook command again to configure the system.
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.
-
Configure your name resolution and
/etc/hostssettings according to your desired configuration. The RHEL System Roles for SAP can also be used to maintain your/etc/hostsfile (using the parameterssap_domainandsap_general_preconfigure_modify_etc_hosts) but for simplicity, we assume that your name resolution and the content of/etc/hostsare configured already. - Ensure that your release lock is set according to your needs and that you have enabled the desired repositories. The RHEL System Roles for SAP can also be used to set the release lock and enable the repos but for simplicity, we assume that these configuration settings are already done.
-
Create a file named
sap-vars.ymlwith the content shown in the previous section. It updates your system to the latest patch level. If this is not desired, setsap_general_preconfigure_updateandsap_hana_preconfigure_updatetofalse, comment out these lines by prepending them with#, or remove these two lines: Create a file named
sap-abap.ymlwith the following content:--- - hosts: localhost collections: - redhat.sap_install become: true roles: - sap_general_preconfigure - sap_netweaver_preconfigureRun the following command:
# ansible-playbook sap-abap.yml -e @sap-vars.ymlThis configures this system according to the applicable SAP notes for SAP HANA on RHEL 10.
After the ansible-playbook command has finished, reboot the system:
# reboot
4.4. Configuring the system for SAP HANA and SAP ABAP Platform on the same host with RHEL System Roles for SAP Copy linkLink copied to clipboard!
For configuring the system for SAP HANA and ABAP Platform, the steps are nearly identical to the steps described in the previous chapter.
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.
-
Configure your name resolution and
/etc/hostssettings according to your desired configuration. The RHEL System Roles for SAP can also be used to maintain your/etc/hostsfile (using the parameterssap_domainandsap_general_preconfigure_modify_etc_hosts) but for simplicity, we assume that your name resolution and the content of/etc/hostsare configured already. - Ensure that your release lock is set according to your needs and that you have enabled the desired repositories. The RHEL System Roles for SAP can also be used to set the release lock and enable the repos but for simplicity, we assume that these configuration settings are already done.
-
Create a file named
sap-vars.ymlwith the content shown in the previous section. It updates your system to the latest patch level. If this is not desired, setsap_general_preconfigure_updateandsap_hana_preconfigure_updatetofalse, comment out these lines by prepending them with#, or remove these two lines: Create a file named
sap-hana_abap.ymlwith the following content:--- - hosts: localhost collections: - redhat.sap_install become: true roles: - sap_general_preconfigure - sap_netweaver_preconfigure - sap_hana_preconfigureRun the following command:
# ansible-playbook sap-hana_abap.yml -e @sap-vars.ymlThis configures this system according to the applicable SAP notes for SAP HANA on RHEL 10. Run the role
sap_hana_preconfigureafter the rolesap_netweaver_preconfigureto ensure the configuration of certain specific settings for SAP HANA (e.g.kernel tunables).After the ansible-playbook command has finished, reboot the system:
# reboot