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 $DIR_NEW, 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.

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.

Context

An upgrade is only performed if a version of the SAP Host Agent executable programs is found in the $DIR_NEW directory that is higher than the version of the executable programs that exist in the SAP Host Agent executable directory.

Recommendation The production version of the SAP Host Agent is available for customers as a digitally signed SAR archive. It is recommended that you create an empty file .verify in the $DIR_NEW directory to enable the verification of the package integrity using SAP digital signature during the auto-upgrade step.

Procedure

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

      Windows: If the new SAP Host Agent version is located on a network share, you have to use the UNC path for the value of the DIR_NEW profile parameter, for example: DIR_NEW = \\<your_host>\<your_share>\SAPHostAgent\SAPHostAgent_Update

  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
Related Information