Installing SAP Host Agent Manually

You can install SAP Host Agent manually by executing the saphostexec executable with option -install from the extracted SAPHOSTAGENT<SP-version>.SAR archive.

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. If user profile R3GROUP does not exist on your server, it will be created during the installation of SAP Host Agent. If you have already installed SAP systems on other servers, we recommend that you use the same group ID (GID) for all sapsys and R3GROUP groups in the system landscape. To obtain the group ID (GID) for R3GROUP on another IBM i server in your landscape, enter the command DSPUSRPRF USRPRF(R3GROUP) and scroll down until you see the value for Group ID number.

2. IBM i only: Enter the command CALL PGM(QP2TERM) to start a PASE interactive terminal session.
3. Download the SAPHOSTAGENT<SP-version>.SAR archive as described in Downloading the SAPHOSTAGENT Archive
4. Copy the downloaded SAPHOSTAGENT<SP-version> archive to a temporary directory, for example:

   Windows	c:\temp\hostagent
   UNIX, IBM i	/tmp/hostagent

5. 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	/<path to SAPCAR>/sapcar -xvf <path to temporary directory>/SAPHOSTAGENT<SP-version>.SAR -manifest SIGNATURE.SMF
   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.
6. Start the installation by entering the following command:

   Windows	<path to temporary directory>\saphostexec.exe -install If user sapadm does not yet exist, it is automatically created as a local user and you are prompted to enter a password for this user to be created. Note In some cases it might be useful to configure sapadm as a domain user instead of a local user, for example if you have multiple Windows hosts in your system landscape each of which has SAP Host Agent. Enter the following command to install saphostexec while specifying sapadm as the domain user: <path to temporary directory>\saphostexec.exe -install -user <domain>\sapadm Recommendation Use the additional parameter -verify to verify the content of the installation package against the SAP digital signature:
   UNIX	<path to temporary directory>/saphostexec -install The administrator user sapadm of the SAP Host Agent is created automatically during the installation, but it does not get assigned a password. Note You can set the password in one of the following ways: During the installation using the following command: <path to temporary directory>/saphostexec -install -passwd In this case saphostexec will prompt you to enter a password After the installation has finished by entering the following command as user root: passwd sapadm Recommendation Use the additional parameter -verify to verify the content of the installation package against the SAP digital signature:
   IBM i	<path to temporary directory>/saphostexec -install -gid <gid> Note If you have already installed SAP systems on other servers, we recommend that you use the same group ID (GID) for all sapsys or R3GROUP groups in the system landscape. To do this, enter your landscape system GID into <gid> on the above command. If user profile R3GROUP already exists, or if you want the saphostcontrol installation to automatically generate a new group ID, enter the command <path to temporary directory>/saphostexec -install without the addition -gid <gid> . Recommendation Use the additional parameter -verify to verify the content of the installation package against the SAP digital signature:

   The progress of the installation is displayed on the command line.
7. After the installation has finished successfully, you can check whether SAP Host Agent is up and running by executing the following command from the directory of the SAP Host Agent executables:

   Windows	%ProgramFiles%\SAP\hostctrl\exe\saphostexec.exe -status
   UNIX, IBM i	/usr/sap/hostctrl/exe/saphostexec -status

8. IBM i only: Leave the PASE interactive terminal session using function key F3