Upgrading SAP Host Agent from Extracted SAPHOSTAGENT Archive

You can upgrade the SAP Host Agent by running saphostexec -upgrade from the directory to which you extracted the downloaded SAPHOSTAGENT<SP-version>.SAR archive.

Prerequisites

You have downloaded the required 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
   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. Extract the SAPHOSTAGENT<SP-version>.SAR archive using SAPCAR.
   Take SAP Note 212876  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 <path to temporary directory>\SAPHOSTAGENT<SP-version>.SAR -manifest SIGNATURE.SMF
   UNIX, IBM i	/<path to SAPCAR>/sapcar -xvf <path to temporary directory>/SAPHOSTAGENT<SP-version>.SAR -manifest SIGNATURE.SMF

   Among others, the archive contains the saphostexec program.
5. Perform the upgrade by running the following command:

   Windows	<path to temporary directory>\saphostexec.exe -upgrade Recommendation You can use the additional parameter -verify to verify the content of the installation package against the SAP digital signature
   UNIX, IBM i	/<path to temporary directory>/saphostexec -upgrade Recommendation You can use the additional parameter -verify to verify the content of the installation package against the SAP digital signature

   The progress of the upgrade is displayed on the command line.
6. 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	If you are logged on as a user with root authorization, the command is as follows: /usr/sap/hostctrl/exe/saphostexec -version 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 -version
   IBM i	/usr/sap/hostctrl/exe/saphostexec -version

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