Show TOC

Procedure documentationDownloading and Installing Package SAPHOSTAGENT for ACC Locate this document in the navigation structure

 

The SAPHOSTAGENT package contains all of the required elements for centrally monitoring any host. It is automatically installed during the installation of any components of SAP NetWeaver 7.0 EhP 2 and higher. However, on each host with an SAP component managed by the Adaptive Computing Controller (ACC), check whether the host agent is installed and running.

You can also install the host agent using the program SAPinst; the files required for this are on the kernel DVD for the current release. For more information, refer to the installation guide at service.sap.com/instguidesnw; to do this, choose the desired release and the Installation area.

Note Note

If you are using an SLD, register the host with the SLD after installing the host agent (see Registering Hosts with the SLD Using sldreg). You need this data in the SLD, for example, for the Adaptive Computing Infrastructure.

End of the note.

The SAPHOSTAGENT package contains the following elements, among others:

Prerequisites

You have the archive SAPHOSTAGENT.SAR.

You can find SAPHOSTAGENT.SAR in the SAP Software Distribution Center of the SAP Service Marketplace (http://service.sap.com/swdc). Log on with your SAP Service Marketplace ID and go to the following folder:

In the navigation bar, choose   Download   Support Packages and Patches   Entry by Application Group   SAP Technology Components   SAP HOST AGENT   SAP HOST AGENT 7.11   <operating system>  , and download the archive.

Procedure

Installation Under Windows

Note Note

Before the installation, ensure that you have installed the specified Microsoft security patch in accordance with the instructions in SAP Note 1375494 .

End of the note.
  1. For the installation, there must be a sapadm user with administrator authorizations on the host and a SAP_LocalAdmin group. The procedure for Microsoft Windows XP is presented here as an example. In other versions of Microsoft Windows, the procedure will differ slightly:

    1. Choose   Start   Settings   Control Panel   User Accounts,   switch to the Advanced tab page, and choose the Advanced button in the Advanced user management group box.

    2. Choose Groups. Choose the menu path   Action   New Group  ..., and create a new group called SAP_LocalAdmin. Close the New Group window again.

    3. In the navigation bar, choose Users. Choose the menu path   Action   New User  ..., and make the required settings. Close the Local Users and Groups window again.

    4. So that the user has the required authorizations, switch back to the Users tab page in the User Accounts window, and double-click the sapadm that you have just created. On the Group Membership tab page, add the user to the Administrators group.

      Note Note

      The sapadm user requires authorization to create a service. If the user is a local administrator, it has this authorization. However, you can also alternatively set this specific authorization manually:

      1. On the Microsoft Windows host, choose   Start   Control Panel   Administrative Tools   Local Security Policy  .

      2. In the navigation bar, choose   Security Settings   Local Policies   User Rights Assignment  , and then double-click the line Log on as a service.

      3. Add the sapadm user to the list by choosing the Add User or Group… button and entering this user.

      4. Close the window by choosing OK.

      End of the note.
  2. The SAPOSCOL working directory needs to exist on the host. If it does not already exist, create the directory c:\usr\sap\PRFCLOG, and release the directory sap as a share with the name saploc.

  3. Decompress the SAPHOSTAGENT.SAR archive with the SAPCAR tool. Take SAP Note 212876 into account when doing so. Normally, you use the following command for decompression, and execute it in the directory of the archive:

    sapcar -xvf SAPHOSTAGENT.SAR

  4. In addition, the archive contains the saphostexec program. Install SAPHOSTCONTROL by entering the following command:

    saphostexec -install

  5. In the next step, a window appears in which you can enter information about the desired operation and the user to be used for the operation. Enter the password of the sapadm user.

    Note Note

    The default setting for the user is .\sapadm, that is, sapadm is a local user. If sapadm is a domain user, delete the prefix .\.

    End of the note.
Installation Under UNIX
  1. You need to perform the installation under root. Therefore, switch to the root user.

  2. The sapsys group needs to exist on the host. If it does not yet exist, create the group, for example with the command groupadd.

  3. The user sapadm needs to exist on the host, and must be a member of the sapsys group. If the user does not yet exist, create the user, for example with the command useradd.

  4. The SAPOSCOL working directory needs to exist on the host. If it does not yet exist, create the directory usr/sap/tmp.

  5. Decompress the SAPHOSTAGENT.SAR archive with the SAPCAR tool. Take SAP Note 212876 into account when doing so. Normally, you use the following command for decompression, and execute it in the directory of the archive:

    sapcar -xvf SAPHOSTAGENT.sar

  6. In addition, the archive contains the saphostexec program. Install SAPHOSTCONTROL by entering the following command:

    saphostexec -install

Installation on IBM i

Caution Caution

The SAPHOSTAGENT runs in subsystem QUSRWRK. Therefore, you must activate this subsystem so it comes up after IPL.

End of the caution.
  1. Log on with a user of type QSECOFR.

    Note: This user is required for the installation.

  2. Open a QP2TERM session and use the following command to change to the directory to which you downloaded the archive. Use the following command to do this:

    cd <archive directory>

  3. Decompress the SAPHOSTAGENT.SAR archive with the SAPCAR tool. For more information about SAPCAR, see SAP Note 212876. Use the following command for decompression, executing it in the directory of the archive:

    /<sapcar path>/sapcar -xvf SAPHOSTAGENT.SAR

  4. If the user profile SAPADM and the user group R3GROUP do not exist on the host, do the following:

    1. To create the SAP_TOOLS library required to create SAPADM, call program iletools (which is contained in the archive) as follows:

      iletools ./ILE_TOOLS

    2. Exit the QP2TERM session and enter the following commands:

      ADDLIBLE SAP_TOOLS

      FIXSAPOWN SID(*NONE) LIB(SAP_TOOLS)

      CRTSAPUSR USER(*SAPADM)

  5. If you skipped the previous step, exit the QP2TERM session.

  6. If the SAPOSCOL working directory does not yet exist on the host, create the directory usr/sap/tmp.

  7. Assign full authorization for /usr/sap and /usr/sap/tmp to the group R3GROUP.

  8. Open a QP2TERM session again, and change to the directory where you decompressed the archive.

  9. In addition, the archive contains the saphostexec program. Install SAPHOSTCONTROL by entering the following command:

    saphostexec -install

    This installs SAPHOSTCONTROL under the IFS directory /usr/sap/hostctrl and in the library R3SAP400.

Result

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

  • The control program saphostexec

  • The operating system collector saposcol

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

    Note Note

    The installed programs are automatically started when the host is booted. On Microsoft Windows hosts, this is done by the services SAPHostControl and SAPHostExec. On UNIX hosts the automatic start is ensured by the startup script sapinit, which starts the required executables.

    On IBM i, the programs are started by the auto-start job (ADDAJE)SAPINIT in subsystem QUSRWRK, which was created during the installation.

    End of the note.
Upgrade

If you want to perform an upgrade manually for the host agent, proceed as follows:

  • Upgrade Under Microsoft Windows

    Download the archive SAPHOSTAGENT.SAR from the SAP Service Marketplace as described above, and extract the archive into a temporary directory.

    The archive contains the saphostexec program. Perform the upgrade by switching to this temporary directory and running the command saphostexec -upgrade there.

    After the upgrade, you can delete the temporary directory again.

  • Upgrade Under UNIX

    Download the archive SAPHOSTAGENT.SAR from the SAP Service Marketplace as described above, and extract the archive into a temporary directory.

    Switch to the root user and perform the upgrade by switching to this temporary directory and running the command saphostexec -upgrade there.

    After the upgrade, you can delete the temporary directory again.

Uninstallation

If you want to uninstall the host agent again, use the following command:

saphostexec -uninstall

This stops the above executables and services and deletes the working directory of the host agent.