Show TOC

Upgrading SAP Host Agent ManuallyLocate this document in the navigation structure

You perform the upgrade by running saphostexec -upgrade from the directory to which you extracted the SAPHOSTAGENT<SP-version>.SAR archive before.

Prerequisites

You have downloaded the desired target release version of the SAPHOSTAGENT<SP-version>.SAR archive as described in Downloading the SAPHOSTAGENT Archive.

Procedure

  1. Log on as a user with the required authorization:
    Windows As a member of the local Administrators group
    UNIX As a user with root authorization or as a member of the sapsys group, for example <sapsid>adm
    IBM i As a user profile with special authorities *SECADM and *ALLOBJ, for example as user profile QSECOFR.
  2. IBM i only: Enter the command CALL PGM(QP2TERM) to start a PASE interactive terminal session.
  3. Copy the downloaded SAPHOSTAGENT<SP-version>.SAR archive to a temporary directory, for example:
    Windows c:\temp\hostagent
    UNIX, IBM i /tmp/hostagent
  4. Change to the temporary directory that now contains the downloaded SAPHOSTAGENT<SP-version>.SAR archive.
  5. Extract the SAPHOSTAGENT<SP-version>.SAR archive using SAPCAR.

    Take SAP Note 212876 Information published on SAP site into account when doing so. Use the following command for extraction, and execute them in the directory of the archive:

    Windows <path to SAPCAR> sapcar.exe -xvf SAPHOSTAGENT<SP-version>.SAR
    UNIX <path to SAPCAR> sapcar -xvf SAPHOSTAGENT<SP-version>.SAR
    IBM i <path to SAPCAR> SAPCAR -xvf SAPHOSTAGENT<SP-version>.SAR
    Among others, the archive contains the saphostexec program.
  6. Perform the upgrade by running the following command from the temporary directory:
    Windows saphostexec.exe -upgrade
    UNIX
    • If you are logged on as a user with root authorization, the command is as follows: ./saphostexec -upgrade
    • If you are logged on as a member of the sapsys group, for example <sapsid>adm, the command is as follows: /usr/sap/hostctrl/exe/hostexecstart -upgrade <path to temporary directory with extracted SAPHOSTAGENT<SP-version>.SAR>
    IBM i ./saphostexec -upgrade
    The progress of the upgrade is displayed on the command line.
  7. After the upgrade has finished successfully, you can check the version of the upgraded host agent by executing the following command from the directory of the SAP Host Agent executables:
    Windows %ProgramFiles%\SAP\hostctrl\exe\saphostexec.exe -version
    UNIX, IBM i /usr/sap/hostctrl/exe/saphostexec -version
  8. IBM i only: Leave the PASE interactive terminal session using function key F3

Next Steps

Post-requisites:

You can now delete the temporary directory with all its content.
Example
Windows c:\temp\hostagent
UNIX, IBM i /tmp/hostagent
Related Information