Show TOC

Procedure documentationConfiguring the Automated Upgrade Behavior of SAP Host Agent Locate this document in the navigation structure

 

The running saphostexec executable regularly checks a directory, by default /usr/sap/hostctrl/new (on UNIX and IBM i) or %ProgramFiles%\SAP\hostctrl\new (on Windows), where it expects to find the latest version of the executable of SAP Host Agent from the unpacked SAPHOSTAGENT.SAR archive. An upgrade is only performed if a version of the SAP Host Agent executable programs is found in the new directory that is higher than the version of the executable programs that exist in the SAP Host Agent executable directory.

Prerequisites

  • Windows: You must be logged on as a member of the local Administrators group.

  • UNIX: You must be logged on as a user with root authorizations.

  • IBM i: You must be logged on as a user profile with special authorities *SECADM and *ALLOBJ, for example as user profile QSECOFR.

Procedure

You can configure the automated upgrade behavior by adapting the host_profile file in the $DIR_EXECUTABLE directory, where $DIR_EXECUTABLE is the path to the directory where the executables saphostcontrol and saphostexec of SAP Host Agent are located: /usr/sap/hostctrl/exe (UNIX and IBM i), %ProgramFiles%\SAP\hostctrl\exe (Windows).

  • By default, the saphostexec program performs a check for updates every 5 minutes. You can change this behavior by adapting profile value hostexec/autoupgrade_delay=<minutes>.

  • In addition, you can also change the name and path of the directory that contains the newest SAP Host Agent version using profile value DIR_NEW=<path to a directory>.

Result

Once you have changed the SAP Host Agent profile, you need to restart SAP Host Agent in order to make the changes take effect:

  1. IBM i: Enter the command CALL PGM(QP2TERM) to start a PASE interactive terminal session .

  2. Change to the directory of the saphostexec executable.

    • /usr/sap/hostctrl/exe (UNIX and IBM i)

    • %ProgramFiles%\SAP\hostctrl\exe (Windows)

  3. Run the following command to restart SAP Host Agent:

    saphostexec -restart