8/29/2017

Upgrading SAP Host Agent Without Extracting the SAPHOSTAGENT Archive

You can upgrade the SAP Host Agent by running saphostexec -upgrade -archive or hostexecstart -upgrade from the hostctrl directory of the existing SAP Host Agent installation with specifying the location of 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:
    WindowsAs a member of the local Administrators group
    UNIXAs a user with root authorization or as a member of the sapsys group, for example <sapsid>adm
    IBM iAs 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:
    Windowsc:\temp\hostagent
    UNIX ,
    IBM i
    /tmp/hostagent
  4. Perform the upgrade by running the following command:
    Windows
    %ProgramFiles%\SAP\hostctrl\saphostexec -upgrade -archive <path to downloaded SAPHOSTAGENT<SP-version>.SAR>
    Recommendation
    Use the additional parameter -verify to verify the content of the installation package against the SAP digital signature:
    UNIX
    • If you are logged on as a user with root authorization, the command is as follows:
      /usr/sap/hostctrl/saphostexec -upgrade -archive <path to downloaded SAPHOSTAGENT<SP-version>.SAR>
    • 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 downloaded SAPHOSTAGENT<SP-version>.SAR>
    Recommendation
    Use the additional parameter -verify to verify the content of the installation package against the SAP digital signature:
    IBM i
    /usr/sap/hostctrl/exe/saphostexec -upgrade -archive <path to downloaded SAPHOSTAGENT<SP-version>.SAR>
    Recommendation
    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.
  5. 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
  6. 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.

No comments:

Post a Comment

Popular Posts