This role installs SAP HANA on a RHEL 7.x or 8.x system and applies a permament HANA License.
This role is intended to use on a RHEL system that gets SAP software. So your system needs to be installed with at least the RHEL core packages, properly registered and prepared for HANA or Netweaver installation.
It needs access to the software repositories required to install SAP HANA (see also: How to subscribe SAP HANA systems to the Update Services for SAP Solutions)
You can use the redhat_sap.sap_rhsm Galaxy Role to automate this process
To install SAP software on Red Hat Enterprise Linux you need some additional packages which come in a special repository. To get this repository you need to have one of the following products:
- RHEL for SAP Solutions (premium, standard, developer Edition)
- RHEL for Business Partner NFRs
Click here to achieve a personal developer edition of RHEL for SAP Solutions. Please register as a developer and download the developer edition.
- Registration Link : Here you can either register a new personal account or link it to an already existing personal Red Hat Network account.
- Download Link: Here you can download the Installation DVD for RHEL with your previously registered account
NOTE: This is a regular RHEL installation DVD as RHEL for SAP Solutions is no additional product but only a special bundling. The subscription grants you access to the additional packages through our content delivery network(CDN) after installation.
It is also important that your disks are setup according to the SAP storage requirements for SAP HANA. This BLOG is also quite helpful when sizing HANA systems.
variable | info | required? |
---|---|---|
sap_hana_deployment_bundle_path | Target host directory path where SAP Installation Bundle SAR file is located | yes |
sap_hana_deployment_bundle_sar_file_name | Installation Bundle SAR file name | yes |
sap_hana_deployment_sapcar_path | Target host directory directory path where SAPCAR tool file is located | yes |
sap_hana_deployment_sapcar_file_name | SAPCAR tool file name | yes |
sap_hana_deployment_deploy_hostagent | Whatever you want to deploy SAP HostAgent or not | no, defaulted to n value |
sap_hana_deployment_use_master_password | Use single master password for all users, created during installation | no, defaulted to n value |
sap_hana_deployment_common_master_password | Common password for both OS users and DB Administrator user (SYSTEM) | no, only if sap_hana_deployment_use_master_password is y |
sap_hana_deployment_root_password | Root User Password | yes |
sap_hana_deployment_sapadm_password | SAP Host Agent User (sapadm) Password | no, will take the value from sap_hana_deployment_common_master_password when sap_hana_deployment_use_master_password is y |
sap_hana_deployment_sidadm_password | Password for user <sid>adm | no, will take the value from sap_hana_deployment_common_master_password when sap_hana_deployment_use_master_password is y |
sap_hana_deployment_hana_db_system_password | Database User (SYSTEM) Password | no, will take the value from sap_hana_deployment_common_master_password when sap_hana_deployment_use_master_password is y |
sap_hana_deployment_ase_user_password | SAP ASE Administrator Password | yes |
sap_hana_deployment_xs_org_password | XS Advanced Admin User Password | Only if sap_hana_deployment_xs_install is y |
sap_hana_deployment_lss_user_password | Local Secure Store User Password | no |
sap_hana_deployment_lss_backup_password | Local Secure Store Auto Backup Password | no |
sap_hana_deployment_hana_install_path | Installation Path for SAP HANA | no, defaulted to /hana/shared value |
sap_hana_deployment_hana_sid | SAP HANA System ID | yes |
sap_hana_deployment_hana_instance_number | Instance Number | yes - note the required double quotes while adding the variable to your inventory so this is interpreted as a string |
sap_hana_deployment_hana_env_type | System Usage, Valid values: production, test, development or custom | no, defaulted to production value |
sap_hana_deployment_hana_mem_restrict | Restrict maximum memory allocation | no, defaulted to y value |
sap_hana_deployment_hana_max_mem | Maximum Memory Allocation in MB | yes (unless sap_hana_deployment_hana_mem_restrict value is n ) |
sap_hana_deployment_hana_userid | System Administrator User ID (sidadm) | no, defaulted to next available user ID |
sap_hana_deployment_hana_groupid | ID of User Group | no, defaulted next available group ID |
sap_hana_deployment_system_restart | Restart system after machine reboot | no, defaulted to n |
sap_hana_deployment_xs_install | Install XS Advanced in the default tenant database | no, defaulted to n |
sap_hana_deployment_xs_path | XS Advanced App Working Path | Only if sap_hana_deployment_xs_install is y |
sap_hana_deployment_xs_orgname | Organization Name For Space "SAP" | Only if sap_hana_deployment_xs_install is y , defaulted to orgname |
sap_hana_deployment_xs_org_user | XS Advanced Admin User | Only if sap_hana_deployment_xs_install is y , defaulted to XSA_ADMIN |
sap_hana_deployment_xs_prod_space | Customer Space Name | Only if sap_hana_deployment_xs_install is y , defaulted to PROD |
sap_hana_deployment_xs_routing_mode | Routing Mode (Valid values: ports and hostnames) | Only if sap_hana_deployment_xs_install is y , defaulted to ports |
sap_hana_deployment_xs_domain_name | XS Advanced Domain Name | Only if sap_hana_deployment_xs_install is y |
sap_hana_deployment_xs_sap_space_user | XS Advanced SAP Space OS User ID | Only if sap_hana_deployment_xs_install is y |
sap_hana_deployment_xs_customer_space_user | XS Advanced Customer Space OS User ID | Only if sap_hana_deployment_xs_install is y |
sap_hana_deployment_xs_components | XS Advanced Components | Only if sap_hana_deployment_xs_install is y |
sap_hana_deployment_xs_components_nostart | Do not start the selected XS Advanced components after installation | Only if sap_hana_deployment_xs_install is y , defaulted to none |
sap_hana_deployment_lss_user | Local Secure Store User ID | no |
sap_hana_deployment_lss_group | Local Secure Store User Group ID | no |
sap_hana_deployment_apply_license | Whether to apply a License File to the deployed HANA instance | no, defaulted to 'false' |
sap_hana_deployment_license_path | Target host directory path where HANA license file located | no, required if sap_hana_deployment_apply_license true |
sap_hana_deployment_license_file_name | HANA license file name | no, required if sap_hana_deployment_apply_license true |
While using this role 2 different scenarios can be covered. These are SAP HANA deployment in a new RHEL Server and set the HANA DB License in an existing deployment.
In order the role to run the first scenario, SAP HANA deployment in a new RHEL Server, the variable sap_hana_deployment_apply_license
must be false
.
In order the role to run the second scenario, set the HANA DB License in an existing deployment, the variable sap_hana_deployment_apply_license
must be true
.
Variables required for both scenarios are the ones specified already.
Before using this role ensure your system has been configured properly to run SAP applications and HANA.
You can use the supported roles sap-preconfigure
and sap-hana-preconfigure
comming with RHEL 7 and 8 with RHEL for SAP Solutions Subscription
The upstream version of these role can be found here and here
- hosts: servers
roles:
- role: sap-hana-deployment
sap_hana_deployment_bundle_path: /usr/local/src
sap_hana_deployment_bundle_sar_file_name: IMDB_SERVER20_045_0-80002031.SAR
sap_hana_deployment_sapcar_path: /usr/local/src
sap_hana_deployment_sapcar_file_name: SAPCAR_1311-80000935.EXE
sap_hana_deployment_root_password: "mysecretpassword"
sap_hana_deployment_sapadm_password: "mysecretpassword"
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: "mysecretpassword"
sap_hana_deployment_ase_user_password: "mysecretpassword"
sap_hana_deployment_apply_license: true
sap_hana_deployment_license_path: /usr/local/src
sap_hana_deployment_license_file_name: RHE.txt
GPLv3
Red Hat SAP Community of Practice