This role is now deprecatd

sap-hana-hostagent

SAP Host Agent is an agent that can accomplish several life-cycle management tasks, such as operating system monitoring, database monitoring, system instance control and provisioning.

It is recommended to install sap-host agent upfront in any HA environment.

You can find the latest Documentation in SAP NOTE 1907566

This role installs or updates teh sap host agent on a RHEL 6.7 or 7.x system. It is provided as RPM package, tarball or as part of an SAP softwarebundle. While Redhat recommends RPM for easier upgrade, this role take care of all formats.

Requirements

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 subscribe-rhn role to automate this process

To install SAP software on Red Hat Enterprise Linux 6 or 7 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. You can use the disk-init role to automate this process

If you want to use this system in production make sure time service is configured correctly. You can use rhel-system-roles to automate this

Role Variables

There are variables that are used through all sap-*, sap-hana-* roles. These variables are prefixed accordingly with sap_, sap_hana_ instead of the complete rolename.

Global Variables

The following variables may be used across all sap-* roles:

# SAP ProfilePath (You should not need to change the default)
sap_usr_sap: "/usr/sap"

# HANA Shared directory
sap_hana_shared: "/hana/shared"
# HANA log Directory
sap_hana_log: "/hana/log"
# HANA data Directory
sap_hana_data: "/hana/log"

The following variable define the UID and GID for the required user to run hostagent. As this might be used in other SAP software as well, the are prefixed as global variable:

sap_sapadm_uid: 20202
sap_sapadm_pw_clear: "MyS3cret!" 
sap_sapsys_gid: 20202

Mandatory Role variables

For the above user, you need to define a password for authentication and SSL encryption:

sap_hana_hostagent_ssl_pw: "MyS3cret!"

It is recommended to use ansible-vault to encrypt these variables.

# Define either one of the following variables depending on installation method
#sap_hana_hostagent_installdir: /path/to/unpacked/hostagent packages
#sap_hana_hostagent_rpm: /path/to/hostagentrpm
#sap_hana_hostagent_archive: /path/to/sap_hana_hostagent_archive

Please note: If you use RPM please honor the following:

• the default profile path /usr/sap must not be changed
• it is recommended to add the RPM package to a custom repository or satellite. In that case just add the name in sap_hana_hostagent_rpm

Optional Role Variables

if you do an install or upgrade from archive you need to define your unarchive command. If you already have a previous version on your system it is likely to be /usr/sap/hostctrl/exe/SAPCAR So this is the default then

sap_hana_hostagent_unarchive_cmd: "/usr/sap/hostctrl/exe/SAPCAR xvf"

Example Playbook

Here is an example playbook that installs SAP hostagent

License

Author Information

Markus Koch

Please leave comments in the github repo issue list