Show TOC

Procedure documentationManually Upgrading SAP Host Agent on Windows Locate this document in the navigation structure

 

You can upgrade SAP Host Agent from a downloaded SAPHOSTAGENT<SP-version>.SAR archive with a higher version. You perform the upgrade by executing the saphostexec executable with the -upgrade option and providing the path to the downloaded SAPHOSTAGENT<SP-version>.SAR archive.

You can use the saphostexec executable either of the existing SAP Host Agent installation or of the downloaded SAPHOSTAGENT<SP-version>.SAR archive. If you use the saphostexec executable of the existing SAP Host Agent installation, you do not need to decompress the downloaded SAPHOSTAGENT<SP-version>.SAR archive manually but execute the program with the additional option -archive and provide the direct path to the downloaded SAPHOSTAGENT<SP-version>.SAR archive.

Prerequisites

  • You are logged on as a member of the local Administrator group.

  • You have downloaded the desired target release version of the SAPHOSTAGENT<SP-version>.SAR archive.

Procedure

  • To upgrade SAP Host Agent using the saphostexec executable of the existing SAP Host Agent installation, proceed as follows:

    1. Copy the downloaded SAPHOSTAGENT<SP-version>.SAR archive to a temporary directory, for example c:\temp\hostagent.

    2. Change to the directory where the saphostexec executable of SAP Host Agent is located:

      cd %ProgramFiles%\SAP\hostctrl\exe\

    3. Execute the following command:

      saphostexec.exe -upgrade -archive <path to downloaded SAPHOSTAGENT<SP-version>.SAR>

    Example Example

    saphostexec.exe -upgrade -archive c:\temp\hostagent\SAPHOSTAGENT126_126-20005735.SAR

    End of the example.
  • To upgrade SAP Host Agent using the saphostexec executable of the downloaded SAPHOSTAGENT<SP-version>.SAR archive, proceed as follows:

    1. Copy the downloaded SAPHOSTAGENT<SP-version>.SAR archive to a temporary directory, for example c:\temp\hostagent.

    2. Decompress the SAPHOSTAGENT<SP-version>.SAR archive with the SAPCAR tool to this directory. Take SAP Note 212876 into account when doing so. You normally use the following command for decompression, and execute it in the directory of the archive:

      sapcar.exe -xvfSAPHOSTAGENT<SP-version>.SAR

      Example Example

      sapcar.exe -xvf SAPHOSTAGENT126_126-20005735.SAR c:\temp\hostagent

      End of the example.

      Among others, the archive contains the saphostexec.exe program.

    3. Perform the upgrade by switching to this temporary directory and running the command saphostexec.exe -upgrade there.

Result

  • After the upgrade has finished successfully, SAP Host Agent is up and running.

  • You can check the version of the upgraded host agent by executing the following command: saphostexec.exe -version

  • You can now delete the temporary directory.