redhat_sap.sap_hostagent
THIS ROLE IS NO LONGER SUPPORTED
The newer version is now part of the community.sap_install collection.
sap-hostagent

SAP Host Agent is a tool that helps manage various tasks like monitoring the operating system, checking databases, controlling system instances, and setting up systems.
It's best to install SAP Host Agent in any High Availability (HA) environment from the start.
The latest instructions can be found in SAP NOTE 1907566.
This role helps install or update the SAP Host Agent on RHEL 7.x or 8.x systems. It can be provided as an RPM package, a tarball, or part of an SAP software bundle. Red Hat recommends using RPM for easier upgrades, but this role supports all formats.
Requirements
This role is meant for a RHEL system that will run SAP software. Your system should have at least the core RHEL packages installed, be registered properly, and be ready for installing HANA or Netweaver.
It must have access to the software repositories needed for SAP HANA installation (see: How to subscribe SAP HANA systems to the Update Services for SAP Solutions).
You can automate this with the redhat_sap.sap_rhsm Galaxy Role.
To install SAP software on Red Hat Enterprise Linux, you need extra packages from a special repository. To access this, you need one of the following products:
- RHEL for SAP Solutions (includes premium, standard, and developer editions)
- RHEL for Business Partner NFRs
Click here to get a personal developer edition of RHEL for SAP Solutions. Please sign up as a developer to download it.
- Registration Link: You can create a new account or link it to an existing Red Hat Network account.
- Download Link: Here you can download the RHEL Installation DVD after registering.
NOTE: This is just a regular RHEL installation DVD; RHEL for SAP Solutions is simply a special bundle. The subscription allows you to get additional packages via the content delivery network (CDN) after installation.
Make sure your disks are set up according to the SAP storage requirements for SAP HANA. This BLOG is helpful for sizing HANA systems.
Role Variables
RPM-Based Installations
Variable | Info | Required? |
---|---|---|
sap_hostagent_installation_type | Type of installation for SAP HOST AGENT | Yes, must be rpm |
sap_hostagent_rpm_local_path | Path where the RPM file is located | Yes, unless using the remote path |
sap_hostagent_rpm_remote_path | Path where the RPM file is located (remote) | Yes, unless using the local path |
sap_hostagent_rpm_file_name | Name of the local RPM file | Yes |
sap_hostagent_agent_tmp_directory | Temporary directory path on the target host | No (default provided) |
sap_hostagent_clean_tmp_directory | Whether to remove the temporary directory after install | No (default provided) |
SAR-Based Installations (Content on Ansible Control Node)
Variable | Info | Required? |
---|---|---|
sap_hostagent_installation_type | Type of installation for SAP HOST AGENT | Yes, must be sar |
sap_hostagent_sar_local_path | Path where the SAR file is located | Yes |
sap_hostagent_sar_file_name | Name of the local SAR file | Yes |
sap_hostagent_sapcar_local_path | Path where the SAPCAR tool file is located | Yes |
sap_hostagent_sapcar_file_name | Name of the SAPCAR tool file | Yes |
sap_hostagent_agent_tmp_directory | Temporary directory path on the target host | No (default provided) |
sap_hostagent_clean_tmp_directory | Whether to remove the temporary directory after install | No (default provided) |
SAR-Based Installations (Content Exists on Target Node)
Variable | Info | Required? |
---|---|---|
sap_hostagent_installation_type | Type of installation for SAP HOST AGENT | Yes, must be sar-remote |
sap_hostagent_sar_remote_path | Remote path where the SAR file is located | Yes |
sap_hostagent_sar_file_name | Name of the SAR file | Yes |
sap_hostagent_sapcar_remote_path | Remote path for the SAPCAR archive | Yes |
sap_hostagent_sapcar_file_name | Remote file name of the SAPCAR archive | Yes |
sap_hostagent_agent_tmp_directory | Temporary directory path on the target host | No (default provided) |
sap_hostagent_clean_tmp_directory | Whether to remove the temporary directory after install | No (default provided) |
SAP Bundle-Based Installations
Variable | Info | Required? |
---|---|---|
sap_hostagent_installation_type | Type of installation for SAP HOST AGENT | Yes, must be bundle |
sap_hostagent_bundle_path | Path where the SAP Installation Bundle is located | Yes |
sap_hostagent_agent_tmp_directory | Temporary directory path on the target host | No (default provided) |
sap_hostagent_clean_tmp_directory | Whether to remove the temporary directory after install | No (default provided) |
SSL Configuration
The role will set up the PSE and create a Certificate Signing Request (CSR). Adding signed certificates from a valid Certificate Authority (CA) is not yet supported.
Variable | Info | Required? |
---|---|---|
sap_hostagent_config_ssl | Configures Agent for SSL communication | No (default provided) |
sap_hostagent_ssl_passwd | Password for the CSR | Yes, if sap_hostagent_config_ssl is True |
sap_hostagent_ssl_org | Organization info for the CSR | Yes, if sap_hostagent_config_ssl is True |
sap_hostagent_ssl_country | Country info for the CSR | Yes, if sap_hostagent_config_ssl is True |
Dependencies
Before using this role, ensure your system is set up properly for SAP applications.
You can use the supported sap-preconfigure
role included with RHEL 7 and 8 for RHEL for SAP Solutions subscription.
The upstream version of this role can be found here.
Example Playbook
- hosts: servers
roles:
- { role: sap-hostagent, become: yes }
Example Inventory
For RPM:
sap_hostagent_installation_type: "rpm"
sap_hostagent_rpm_local_path: "/mylocaldir/SAPHOSTAGENT"
sap_hostagent_rpm_file_name: "saphostagentrpm_44-20009394.rpm"
sap_hostagent_clean_tmp_directory: true
For SAR:
sap_hostagent_installation_type: "sar"
sap_hostagent_sar_local_path: "/mylocaldir/SAPHOSTAGENT"
sap_hostagent_sar_file_name: "SAPHOSTAGENT44_44-20009394.SAR"
sap_hostagent_sapcar_local_path: "/mylocaldir/SAPHOSTAGENT"
sap_hostagent_sapcar_file_name: "SAPCAR_1311-80000935.EXE"
sap_hostagent_clean_tmp_directory: true
For SAP Bundle:
sap_hostagent_installation_type: "bundle"
sap_hostagent_bundle_path: "/usr/local/src/HANA-BUNDLE/51053381"
sap_hostagent_clean_tmp_directory: true
License
Apache License 2.0
Author Information
Red Hat SAP Community of Practice
ansible-galaxy install redhat_sap.sap_hostagent