Role install_saphostagent 

The 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.

SAP is providing bug fixes and enhancements for the SAP Host Agent several times per year. It is advised to update the SAP Host Agent with the current version from time to time as preventive action. SAP is providing the SAP Host Agent in the SAP Software Distribution Center (SWDC) as an SAP Archive (SAR) file. The role install_saphostagent can be used to install or upgrade the SAP Host Agent from a downloaded SAR file according to the SAP documentation in SAP Note 1031096.

You can find a link to the latest SAP Host Agent documentation in SAP Note 1907566.

Table of contents

Role install_saphostagent

Requirements 

This role is intended for the operating system IBM AIX. The target system must be enabled to execute Ansible playbooks. For details, see the prerequisites section in Ansible Content for IBM Power Systems - AIX with SAP Software.

Checking prerequisites for installing the SAP Host Agent

Check if the target system has enough free storage.

Tags 

The following tag can be specified optionally. Omitting the tag or specifying tag -t all has the same effect.

Tag	Usage
`install_saphostagent`	Install the SAP Host Agent.

Variables 

Variable	Usage	Required
`insshagnt_dir_download_managednode`	Directory path on the target host where SAR file is located	Yes 1
`insshagnt_input_file_saphostagent_sar`	Name of the SAR file in the download directory on the target host that contains the SAP Host Agent	No 2
`insshagnt_dir_sapcar_default_managednode`	Fallback directory on the target host where SAPCAR is searched	No 1
`insshagnt_dir_sapcar_managednode`	Directory path on the target host where SAPCAR is located	No 3
`insshagnt_file_sapcar`	Local SAPCAR file name	Yes 1
`insshagnt_dir_temp_managednode`	Temporary directory path that will be created on the target host	Yes 1
`insshagnt_bool_clean_dir_temp_managednode`	Boolean variable to indicate if the temporary directory will be removed or not after the installation	Yes 1

Remarks:

1(1,2,3,4,5): Default provided.
2: Defaults to the alphanumerically last filename in insshagnt_dir_download_managednode that is matching the pattern “*.SAR” or “*.sar”.
3: When insshagnt_dir_sapcar_managednode is undefined, SAPCAR will be searched in insshagnt_dir_download_managednode and insshagnt_dir_sapcar_default_managednode.

Defaults 

Suggested default values are provided in defaults/main.yml:

Variable	Default
`insshagnt_dir_download_managednode`	`"/tmp/downloads"`
`insshagnt_dir_sapcar_default_managednode`	`"/usr/sap/hostctrl/exe"`
`insshagnt_file_sapcar`	`"SAPCAR"`
`insshagnt_dir_temp_managednode`	`"/tmp/hostctrl"`
`insshagnt_bool_clean_dir_temp_managednode`	`True`

Dependencies 

None.

Example Playbook 

The example playbook is used to upgrade the SAP Host Agent to patch level 50 on several hosts. It is based on the assumption that a configuration file and an inventory file with contents similar to the configuration documentation exist in the current directory. The necessary SAP Host Agent archive (SAPHOSTAGENT50_50-20009388.SAR) must have been downloaded from the SAP Software Distribution Center and stored in directory /tmp/downloads_sar on each of the hosts. The SAPCAR executable is available from a previous version of the SAP Host Agent in directory /usr/sap/hostctrl/exe or has been downloaded from the SAP Software Distribution Center into the download directory /tmp/downloads_sapcar. The example playbook in the current directory is named install_saphostagent.yml and has the following contents:

- name: Install SAPHOST Agent
  hosts: ibmaix_servers
  vars:
   - insshagnt_input_file_saphostagent_sar: "SAPHOSTAGENT50_50-20009388.SAR"
   - insshagnt_dir_download_managednode: "/tmp/downloads_sar"
   - insshagnt_file_sapcar:    "SAPCAR"
   - insshagnt_dir_temp_managednode: "/tmp/hostctrl"
   - insshagnt_bool_clean_dir_temp_managednode: True
  roles:
   - role: <ansible_dir>/roles/install_saphostagent

To execute this playbook, enter the command:

ansible-playbook --verbose install_saphostagent.yml