THIS ROLE IS OBSOLETE AND NOT MAINTAINED

The new version is being developed in the community.sap_install collection.

The new name is community.sap_install.sap_hana_install.

sap-hana-deployment

This role installs SAP HANA on a RHEL 7.x or 8.x system and activates a permanent HANA License.

Requirements

This role is meant for use on a RHEL system where SAP HANA software will be installed. Your system should have all the required RHEL package groups for SAP HANA, be properly registered, and be ready for HANA installation.

It must have access to the necessary software repositories to install SAP HANA (see: How to subscribe SAP HANA systems to the Update Services for SAP Solutions).

To automate this process, you can use the redhat_sap.sap_rhsm Galaxy Role.

You also need additional packages, which are available in a special repository. You must have one of the following products:

• RHEL for SAP Solutions (premium, standard, developer edition)
• RHEL for Business Partner NFRs

Click here to get a personal developer edition of RHEL for SAP Solutions. Please register as a developer to download the developer edition.

• Registration Link: Here you can register a new personal account or link it to an existing personal Red Hat Network account.
• Download Link: Here you can download the RHEL installation DVD using your previously registered account.

NOTE: This is a regular RHEL installation DVD. RHEL for SAP Solutions is not a separate product, only a special bundle. The subscription provides access to additional packages after installation via our content delivery network (CDN).

To install the required software and configure your system for SAP HANA, use the sap-preconfigure and sap-hana-preconfigure roles from the RHEL System Roles for SAP package, or the sap.rhel.preconfigure and sap.rhel.hana-preconfigure roles from the sap.rhel collection on Red Hat Automation Hub or sap.linux.preconfigure and sap.linux.hana-preconfigure from the sap.linux collection on Galaxy.

Also, ensure that your disks are set up according to the SAP storage requirements for SAP HANA. This BLOG is useful for sizing HANA systems.

Actions performed by the role

Get a valid user and group ID for SAP HANA installation

If no user and group ID is provided using variables sap_hana_deployment_hana_userid or sap_hana_deployment_hana_groupid, the role chooses one based on certain rules.

Install SAP HANA

1. Check or Set Permissions of relevant SAP directories

The role checks or sets permissions for the SAP directories: /hana/shared, /hana/data, /hana/log, and /usr/sap. Use the variables sap_hana_deployment_directories_permissions and sap_hana_deployment_set_permissions for this purpose.

2. Make the SAP HANA installation files available

The SAP HANA installation files need to be available on the managed node before the installation starts. The role can:

• Use an existing HANA installation directory on the managed node

  • In this case, sap_hana_installdir should point to the directory with the hdblcm program.

• Use a SAP HANA installation bundle file (SAR or ZIP) from the managed node, control node, or another node.

  • Provide the following information:
    • Path to extract the SAP HANA installation bundle file on the managed node (sap_hana_deployment_hana_extract_path).
    • Name and path of the SAP HANA installation bundle file (sap_hana_deployment_bundle_file_name and sap_hana_deployment_bundle_path_mn). If it's a SAR file, also provide the name and path of the SAPCAR executable.
    • Add location info if the SAP HANA installation bundle (and SAPCAR file, if applicable) are on the control node or a third node.

3. Run the SAP HANA installation

Once the SAP HANA installation files are available, the installation begins on the managed node. If sap_hana_deployment_addhosts is provided, it adds one or more SAP HANA hosts after the first installation finishes, allowing you to create a SAP HANA scale-out system.

If sap_hana_deployment_install_primary is set to 'n', it adds hosts to an existing SAP HANA installation instead of starting a new one.

4. Apply the SAP HANA license

After a fresh SAP HANA installation, you can apply the SAP HANA license.

Role Variables

(There are many other variables as listed in the original text, which serve specific configuration purposes.)

HANA Deployment and HANA License

This role supports two scenarios: deploying SAP HANA on a RHEL system with or without applying an SAP HANA DB license, and applying a license to an existing deployment.

Dependencies

Before using this role, ensure your system is set up properly for SAP applications and SAP HANA.

You can use sap-preconfigure and sap-hana-preconfigure roles available on RHEL 8 control nodes, included in the RHEL for SAP Solutions Subscription.

You can find the upstream versions of these roles here and here.

Example Playbook

    - hosts: servers
      roles:
        - role: sap-hana-deployment

Example Inventory for initial SAP HANA installation

sap_hana_installdir: /data/sap-install/SAP_HANA_DATABASE
sap_hana_deployment_hana_install_path: '/hana/shared'
sap_hana_deployment_root_password: "R3dh4t123"
sap_hana_deployment_sapadm_password: "R3dh4t123"
sap_hana_deployment_sidadm_password: "R3dh4t123"
sap_hana_deployment_hana_sid: RHE
sap_hana_deployment_hana_instance_number: "01"
sap_hana_deployment_hana_env_type: development
sap_hana_deployment_hana_mem_restrict: 'n'
sap_hana_deployment_hana_db_system_password: "R3dh4t123"
sap_hana_deployment_ase_user_password: "R3dh4t123"
sap_hana_deployment_apply_license: true
sap_hana_deployment_license_path: /data/sap-license
sap_hana_deployment_license_file_name: RHE.txt

License

Apache License 2.0

Author Information

Red Hat SAP Community of Practice