Show TOC

Procedure documentationManually Upgrading SAP Host Agent on UNIX 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.

On UNIX, you can also use the hostexecstart program for upgrading SAP Host Agent as a user without root authorization.

Prerequisites

  • You are logged on as a user with root authorization or at least as user that is a member of the sapsys group.

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

Procedure

  • If you are logged on as a user with root authorization, you can choose between the following options to perform the upgrade:

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

      1. Copy the downloaded SAPHOSTAGENT<SP-version>.SAR archive to a temporary directory, for example /tmp/hostagent.

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

        cd /usr/sap/hostctrl/exe/

      3. Execute the following command:

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

      Example Example

      saphostexec -upgrade -archive /tmp/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 /tmp/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. Normally, you use the following command for decompression, and execute it in the directory of the archive:

        ./sapcar -xvf SAPHOSTAGENT<SP-version>.SAR

        Example Example

        ./sapcar -xvf SAPHOSTAGENT126_126-20005735.SAR /tmp/hostagent

        End of the example.

        Among others, the archive contains the saphostexec program.

      3. Change to the temporary directory and run the command ./saphostexec -upgrade there.

  • If you are logged on as a user that is a member of the sapsys group, for example <sapsid>adm, proceed as follows:

    1. Decompress the downloaded SAPHOSTAGENT<SP-version>.SAR archive to a temporary directory [temp_dir].

    2. Change to this temporary directory and run the hostexecstart -upgrade [temp_dir] command there.

    Example Example

    /usr/sap/hostctrl/exe/hostexecstart -upgrade /tmp/hostagent/

    End of the example.

Result

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

  • If you are logged on as a user with root authorization, you can check the version of the upgraded host agent by executing the following command: saphostexec –version

  • You can now delete the temporary directory.

More Information

Downloading the SAPHOSTAGENT Archive