redhat_sap.sap_hostagent

THIS ROLE IS NO LONGER SUPPORTED

The newer version is now part of the community.sap_install collection.

sap-hostagent Ansible Lint Ansible Galaxy Import

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:

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

Informazioni sul progetto

Deploys `SAPHOSTAGENT` on the given host(s)

Installa
ansible-galaxy install redhat_sap.sap_hostagent
Licenza
apache-2.0
Download
17k
Proprietario
Community repositories for SAP Solutions on Red Hat Technologies