Configuring RHEL 8 for SAP HANA 2 installation

Red Hat Enterprise Linux 8

Red Hat Customer Content Services

Abstract

This guide explains how to configure RHEL 8 for SAP Solutions for the installation of a SAP HANA 2 single-host system

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

Providing feedback on Red Hat documentation

We appreciate your input on our documentation. Please let us know how we could make it better. To do so:

  • For simple comments on specific passages:

    1. Make sure you are viewing the documentation in the Multi-page HTML format. In addition, ensure you see the Feedback button in the upper right corner of the document.
    2. Use your mouse cursor to highlight the part of text that you want to comment on.
    3. Click the Add Feedback pop-up that appears below the highlighted text.
    4. Follow the displayed instructions.
  • For submitting more complex feedback, create a Bugzilla ticket:

    1. Go to the Bugzilla website.
    2. As the Component, use Documentation.
    3. Fill in the Description field with your suggestion for improvement. Include a link to the relevant part(s) of documentation.
    4. Click Submit Bug.

Chapter 1. Installing RHEL 8

You can install RHEL 8 in interactive mode or you can perform an unattended installation using Kickstart. This document explains how to perform an interactive installation.

For Kickstart installation, use Server as your base environment and take into account the recommendations from the SAP HANA Storage Requirements. For a test system, you can remove the default /home file system allocation and use a large root (/) file system.

Prerequisites

  • You have downloaded the installation image for the desired and supported RHEL 8 minor release from the Red Hat Customer Portal.

    Important

    SAP HANA is supported only on particular minor releases of RHEL 8 (for example RHEL 8.2). For more information on which minor RHEL 8 releases are supported by SAP, see the SAP note 2235581.

  • You have downloaded the installation media for the desired and supported SAP HANA 2 SPS04 or SPS05 revision from the SAP Software Downloads Portal.

Procedure

  1. Boot your server from the RHEL 8 installation source.

    For more information on how to boot your server from the RHEL 8 image, see Performing a standard RHEL installation.

  2. Select the language and click Continue.
  3. Under LOCALIZATION, select the desired keyboard layout, supported languages, and time and date.
  4. Under SOFTWARE, click Software Selection.
  5. In the Software Selection window, select Server as your Base Environment and click Done.

    Note

    Do not select any additional software.

  6. Under SYSTEM, click Installation Destination.
  7. In the Installation Destination window, select the storage configuration according to your needs and click Done.

    Note

    Take into account the recommendations from the SAP HANA Storage Requirements. For a test system, you can remove the default /home file system allocation and use a large root (/) file system.

  8. Under SYSTEM, click Network & Host Name, and configure your network connection.
  9. Click Begin Installation.
  10. Configure USER SETTINGS:

    1. To set the root password, click Root Password.
    2. To set user, user name, and password, click User Creation.
  11. Once RHEL is successfully installed, click Reboot.

Chapter 2. Registering your host

This section explains how to register your RHEL server to Red Hat Satellite.

Note

Different steps apply if your system is registered to the Red Hat Customer Portal or your Cloud provider.

Prerequisites

Procedure

  1. Download the Katello client rpm package:

    # wget https://sat.int.example.com/pub/katello-ca-consumer-latest.noarch.rpm

    Replace the URL with the URL provided by your Satellite administrator.

  2. Install the Katello client rpm package:

    # yum install -y katello-ca-consumer-latest.noarch.rpm

    Replace the package name with the name of the package you downloaded.

  3. Register your system:

    # subscription-manager register --org="your-organization-name" \
    --activationkey="your-activation-key"

    Replace your-organization-name with the string representing the name of the organization and replace your-activation-key with the activation key. Both are provided by your Satellite administrator.

    Note

    If you are using an external Ansible control node to register and subscribe your RHEL server to RHEL for SAP Solutions repositories, you can utilize redhat_sap.sap_rhsm ansible role instead of registering your system manually.

    For more information, see sap_rhsm section on the Ansible Galaxy portal.

Chapter 3. Applying the RHEL release lock

SAP supports SAP HANA with certain minor RHEL releases, for example RHEL 8.2. You need to apply a release lock to make sure your RHEL system is set to a certain minor release.

For more information on which minor RHEL 8 releases are supported by SAP, see the SAP note 2235581.

Important

Updating your RHEL system before applying a release lock will result in dependency errors and a possible upgrade to a RHEL 8 minor version that is not supported by SAP HANA. It is advised you run yum installations and updates only after the release lock is applied.

Note that if you used redhat_sap.sap_rhsm ansible role to register and subscribe your RHEL server to RHEL for SAP Solutions repositories you can skip this step and proceed to Installing RHEL System Roles for SAP. For more information, see sap_rhsm section on the Ansible Galaxy portal.

Prerequisites

  • root access

Procedure

  1. Clear the dnf cache:

    # rm -rf /var/cache/dnf
  2. Set the release lock:

    # subscription-manager release --set=8.x

    Replace 8.x with the supported minor release of RHEL 8 (for example 8.2).

Chapter 4. Enabling required repositories

You need to enable certain RHEL repositories to have access to packages required for the SAP HANA installation. For more information on what repositories to enable based on your version of SAP HANA, architecture of your host, and your RHEL minor version, see RHEL for SAP Configurator.

Note that if you used redhat_sap.sap_rhsm ansible role to register and subscribe your RHEL server to RHEL for SAP Solutions repositories you can skip this step and proceed to Installing RHEL System Roles for SAP. For more information, see sap_rhsm section on the Ansible Galaxy portal.

Prerequisites

  • root access.

Procedure

  1. Disable all the repositories:

    # subscription-manager repos --disable="*"
  2. Enable the following repositories:

    # subscription-manager repos \
    --enable="rhel-8-for-$(uname -m)-baseos-e4s-rpms" \
    --enable="rhel-8-for-$(uname -m)-appstream-e4s-rpms" \
    --enable="rhel-8-for-$(uname -m)-sap-solutions-e4s-rpms" \
    --enable="rhel-8-for-$(uname -m)-sap-netweaver-e4s-rpms"
    Note

    If you intend to use the server for the SAP HANA database only, enabling the sap-netweaver-e4s-rpms repository is not required.

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
  2. Install the Ansible Engine:

    # yum install ansible

5.2. Installing RHEL System Roles for SAP

RHEL System Roles for SAP include sap-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

5.3. Server configuration with RHEL System Roles for SAP

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 the 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-preconfigure
        - role: sap-hana-preconfigure
    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

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

  3. Reboot the server.

Additional resources

5.3.2. Configuring a remote managed node

If you have a separate Ansible Engine Control Node, perform the steps outlined in this procedure to automatically configure one or more managed nodes.

Prerequisites

Procedure

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

    host01
    host02

    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-preconfigure
        - role: sap-hana-preconfigure
    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

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

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

  4. Reboot the servers host01 and host02.

Additional resources

Chapter 6. Next steps

After configuring your RHEL 8 for SAP Solutions system(s), you can install SAP HANA. For more information on the installation process, see the SAP HANA Server Installation and Update Guide.

Legal Notice

Copyright © 2021 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.