Show TOC

Procedure documentationManually Installing SAP Host Agent on IBM i Locate this document in the navigation structure

 

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

Prerequisites

  • You must be logged on as a user profile with special authorities *SECADM and *ALLOBJ, for example as user profile QSECOFR.

  • You have downloaded the SAPHOSTAGENT<SP-version>.SAR archive.

  • 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.

    If option 33 of the operating system was installed during this step, we recommend that you install the latest PTFs for your operating system release according to SAP Note 83292.

  • The system startup program (specified in system value QSTRUPPGM) must contain the STRBS command to start subsystem QSYS/QUSRWRK. This is needed because SAPHOSTAGENT will be started as an auto-start job in subsystem QSYS/QUSRWRK.

  • If user profile R3GROUP does not exist on your server, it will be created during the installation of the SAPHOSTAGENT<SP-version>.SAR archive. 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.

Procedure

  1. If it does not exist on your server, create the directory /tmp/hostctrl and then copy or move the downloaded archive SAPHOSTAGENT<SP-version>.SAR and SAPCAR to the directory /tmp/hostctrl.

    Note Note

    This documentation refers to the directory /tmp/hostctrl in some of the steps below. If you want to use a different directory, you have to adjust the commands appropriately.

    End of the note.

  2. Enter the command CALL PGM(QP2TERM) to start a PASE interactive terminal session.

  3. Make the directory that contains SAPCAR and the archive SAPHOSTAGENT<SP-version>.SAR your current directory using the following command:

    cd /tmp/hostctrl

  4. Decompress the archive SAPHOSTAGENT<SP-version>.SAR with the SAPCAR tool using the following command:

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

    Example Example

    ./SAPCAR -xvf SAPHOSTAGENT126_126-20005735.SAR /tmp/hostctrl

    End of the example.

    Among others, the archive contains the saphostexec program.

  5. To install saphostcontrol enter the following command:

    ./saphostexec –install –gid <gid>

    Note 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>.

    End of the note.

  6. Leave the PASE interactive terminal session using function key F3.

    Note Note

    If it did not already exist, R3GROUP was created during the installation. Even though SAP Host Agent does not require special authorities, we recommend that you grant the required authorities for system API’s that need to be authorized for user profile R3GROUP for your SAP system now. For more information, see SAP Note 175852.

    End of the note.

Result

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

  • You have installed and started the following units on your host:

    • The control program saphostexec

    • The operating system collector saposcol

    • The SAP ILE daemon SAPILED

    • The SAP NetWeaver Management agent SAPHostControl (sapstartsrv in host mode)

    • The SAP Database Performance Collector for IBM i, if the /usr/sap/sapservices file contains the related entry as described in SAP Note 1622665.

  • If you use System Landscape Directory (SLD), register the host with the SLD after installing SAP Host Agent (see Registering Hosts with the SLD Using sldreg). You need this data in the SLD, for example, for using the Adaptive Computing Infrastructure.

More Information

Downloading the SAPHOSTAGENT Archive