Show TOC

Configuring the Automated Upgrade Behavior of SAP Host AgentLocate 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.


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.


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.


  1. You can configure the automated upgrade behavior by adapting the host_profile file which you can find in the following directory:
    UNIX and IBM i /usr/sap/hostctrl/exe
    Windows %ProgramFiles%\SAP\hostctrl\exe
    • 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> .

  2. 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:
      UNIX, IBM i /usr/sap/hostctrl/exe
      Windows %ProgramFiles%\SAP\hostctrl\exe
    3. Run the following command to restart SAP Host Agent:
      UNIX, IBM i ./saphostexec -restart
      Windows saphostexec.exe -restart