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.

Prerequisites

Windows	You have installed the specified Microsoft security patch in accordance with the instructions in SAP Note 1375494 . You also need to install the latest version of the Microsoft Runtime used by SAP as described in SAP Note 684106 .
IBM i	Option 33 of the operating system must be installed. Use menu GO LICPGM to check whether the option is installed and install it if required.
IBM i	The system startup program (specified in system value QSTRUPPGM) must contain the STRSBS command to start subsystem QSYS/QUSRWRK. This is needed because SAPHOSTAGENT will be started as an auto-start job in subsystem QSYS/QUSRWRK

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. Change to the temporary directory that now contains the downloaded SAPHOSTAGENT<SP-version>.SAR archive.
6. 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 SAPHOSTAGENT<SP-version>.SAR
   UNIX	<path to SAPCAR> sapcar -xvf SAPHOSTAGENT<SP-version>.SAR
   IBM i	<path to SAPCAR> SAPCAR -xvf SAPHOSTAGENT<SP-version>.SAR

   Among others, the archive contains the saphostexec program.
7. Start the installation by entering the following command:

   Windows	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: saphostexec.exe -install -user <domain>\sapadm
   UNIX	./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. You can assign a password after the installation has finished (see next step).
   IBM i	./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 saphostexec -install without the addition -gid <gid> .

   The progress of the installation is displayed on the command line.
8. UNIX only: If required, assign a password to the sapadm user by entering the following command: passwd sapadm
9. 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 and IBM i	/usr/sap/hostctrl/exe/saphostexec -status

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