Downloading and Installing Package SAPHOSTAGENT for ACC 
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
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.
The SAPHOSTAGENT package contains the following elements, among others:
saphostexec
sapstartsrv
sapacosprep
saposcol
Note
For a description of these elements, see Monitoring Hosts with SAPHostControl and saphostexec.
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 , and download the archive.
Note
Before the installation, ensure that you have installed the specified Microsoft security patch in accordance with the instructions in SAP Note 1375494 .
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:
Choose switch to the Advanced tab page, and choose the Advanced button in the Advanced user management group box.
Choose Groups. Choose the menu path ..., and create a new group called SAP_LocalAdmin. Close the New Group window again.
In the navigation bar, choose Users. Choose the menu path ..., and make the required settings. Close the Local Users and Groups window again.
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
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:
On the Microsoft Windows host, choose .
In the navigation bar, choose , and then double-click the line Log on as a service.
Add the sapadm user to the list by choosing the Add User or Group… button and entering this user.
Close the window by choosing OK.
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.
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
In addition, the archive contains the saphostexec program. Install SAPHOSTCONTROL by entering the following command:
saphostexec -install
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
The default setting for the user is .\sapadm, that is, sapadm is a local user. If sapadm is a domain user, delete the prefix .\.
You need to perform the installation under root. Therefore, switch to the root user.
The sapsys group needs to exist on the host. If it does not yet exist, create the group, for example with the command groupadd.
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.
The SAPOSCOL working directory needs to exist on the host. If it does not yet exist, create the directory usr/sap/tmp.
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
In addition, the archive contains the saphostexec program. Install SAPHOSTCONTROL by entering the following command:
saphostexec -install
Caution
The SAPHOSTAGENT runs in subsystem QUSRWRK. Therefore, you must activate this subsystem so it comes up after IPL.
Log on with a user of type QSECOFR.
Note: This user is required for the installation.
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>
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
If the user profile SAPADM and the user group R3GROUP do not exist on the host, do the following:
To create the SAP_TOOLS library required to create SAPADM, call program iletools (which is contained in the archive) as follows:
iletools ./ILE_TOOLS
Exit the QP2TERM session and enter the following commands:
ADDLIBLE SAP_TOOLS
FIXSAPOWN SID(*NONE) LIB(SAP_TOOLS)
CRTSAPUSR USER(*SAPADM)
If you skipped the previous step, exit the QP2TERM session.
If the SAPOSCOL working directory does not yet exist on the host, create the directory usr/sap/tmp.
Assign full authorization for /usr/sap and /usr/sap/tmp to the group R3GROUP.
Open a QP2TERM session again, and change to the directory where you decompressed the archive.
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.
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
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.
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.
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.
Infrastructure of the SAP NetWeaver Management Agents Start Page