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.
Procedure
- 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. |
- IBM i only: Enter the command CALL
PGM(QP2TERM) to start a
PASE interactive terminal
session.
- Copy the downloaded
SAPHOSTAGENT<SP-version>.SAR
archive to a temporary directory, for example:
| Windows |
c:\temp\hostagent |
| UNIX , IBM i
|
/tmp/hostagent |
- 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.
- 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 |
- 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.