installation_saphostagent

Downloading and Installing PackageSAPHOSTAGENT

The SAPHOSTAGENT package contains some of the required elements for centrallymonitoring any host with the Alert Monitor or the SAP Solution Manager. Depending on therelease of the central system you also need to install the CCMS agent to monitor a hostcentrally. It is automatically installed during the installation of all of the components of SAPNetWeaver 7.1. However, on each host with an SAP component managed by the AdaptiveComputing Controller (ACC), check whether the host agent is installed and running.

You can also install the host agent using the installation tool SAPinst. The files required forthis are on the kernel DVD for the current release. For more information, see the SAP ServiceMarketplace at http://service.sap.com/instguidesnw. To find the installation guide, choose therequired release and the Installation area.

Note

If you are using a System Landscape Directory (SLD), register the host with the SLDafter installing the host agent, as described in Registering Hosts with the SLD Usingsldreg. You need this data in the SLD, for example, for the Adaptive ComputingInfrastructure.

End of the note.

HostProfileSAPSystem=99

SAPSystemName=SAPUser

SAPadm

LocalSocket SAPOsCol

sapacosprep

controlsSAPHostExec

NetWeaver Management Agents on a Host

UsererRoot

or LocalSystem Account

SAPHostControl(sapstartsrv in host mode)

WebService

Clients

The SAPHOSTAGENT package contains the following elements, among others:

saphostexec

http://service.sap.com/instguidesnw.

SAP Online Help 29.09.2010

Downloading and Installing Package SAPHOSTAGENT 734 2

sapstartsrv

sapacosprep

saposcol

PrerequisitesYou have the archive SAPHOSTAGENT.SAR.

You can find SAPHOSTAGENT.SAR in the SAP Software Distribution Center athttp://service.sap.com/swdc Download Support Packages and Patches Entry by

Application Group SAP Technology Components SAP HOST AGENT SAP HOSTAGENT 7.11 <operating system> .

Note

The SAPHOSTAGENT package is only delivered as non-unicode. It is therefore notimportant whether you choose the package from the unicode or non-unicode sector.

If you want to install the SAPHOSTAGENT package on a host with an SAPNetWeaver component, download the same version (32 or 64 bit) as the componentitself. If you want to install the package SAPHOSTAGENT on a host with no SAPcomponent, download the same version (32 or 64 bit) as the operating system of thehost.

End of the note.

ProcedureInstallation Under Windows

Note

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

For the installation, there must be a sapadm user with administrator authorizations on thehost and a SAP_LocalAdmin group. The procedure for Microsoft Windows XP is presentedhere as an example. In other versions of Microsoft Windows, the procedure differs slightly:

1. Do the following:

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

2. In the navigation bar, choose Groups, and then choose the menu pathAction New Group... . Create a new group called SAP_LocalAdmin,

and then close the New Group window.

3. In the navigation bar, choose Users, and then choose the menu pathAction New User... . To create the sapadm user make the required

settings, and then close the New User window.

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

http://service.sap.com/swdc



Note

The sapadm user requires authorization to create a service. To set thisspecific authorization, do the following:

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

2. In the navigation bar, choose Security Settings Local PoliciesUser 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 orGroup… button and entering this user.

4. Close the window by choosing OK.

End of the note.

2. If the SAPOSCOL working directory does not already exist on the host, create thedirectory c:\usr\sap\PRFCLOG, and release the directory sap as a share with thename saploc.

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

sapcar -xvf SAPHOSTAGENT.SAR

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

saphostexec -install

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

Note

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

End of the note.

Installation Under UNIX1. Switch to the root user, because you need to perform the installation under root.

2. If the sapsys group does not yet exist on the host, create it using, for example, thecommand groupadd.

3. If the user sapadm does not yet exist on the host, create it using, for example, thecommand useradd.

The user must be a member of the sapsys group.

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



5. Decompress the SAPHOSTAGENT.SAR archive with the SAPCAR tool, following SAPNote 212876. Normally, you use the following command for decompression andexecuting it in the directory of the archive:

sapcar -xvf SAPHOSTAGENT.sar

6. Among other things, the archive contains the saphostexec program. InstallSAPHOSTCONTROL by entering the following command:

saphostexec -install

Installation on IBM iPreparation

1. Check if option 33 of the operating system („Portable Application SolutionsEnvironment“, required by SAPHOSTAGENT) is installed and install it if necessary.To perform the check and install the product option if required, use the menu GOLICPGM.

If you had to install option 33 during this step, we recommend that you install thelatest PTFs for your operating system release according to SAP Note 83292.

2. Make sure your system startup program (specified in system value QSTRUPPGM)contains the command to start subsystem QSYS/QUSRWRK. This is needed becauseSAPHOSTAGENT is started as an autostart job in subsystem QSYS/QUSRWRK.

3. Download the PASE version of SAPCAR from the SAP Service Marketplace asdescribed in SAP Note 863821. To download SAPCAR, gotohttp://service.sap.com/swdc and then choose SAP Software Distribution Center

Support Packages and Patches Support Packages and Patches - Entry byApplication Group SAP Technology Components SAPCAR SAPCAR 7.10

OS/400.

Rename the downloaded file SAPCAR<…>.EXE to SAPCAR (without extension).

4. Download the PASE version of SAPHOSTAGENT from the SAP ServiceMarketplace. To download SAPHOSTAGENT, goto http://service.sap.com/swdc andthen choose SAP Software Distribution Center Support Packages and Patches

Support Packages and Patches - Entry by Application Group SAP TechnologyComponents SAP HOST AGENT SAP HOST AGENT 7.20 OS/400.

If it does not exist on your server, create the directory /tmp/hostctrl and thencopy or move the downloaded archive SAPHOSTAGENT<…>.SAR and SAPCAR to thedirectory /tmp/hostctrl.

Note

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

End of the note.

5. If user profile R3GROUP does not exist on your server, it will be created during theinstallation of SAPHOSTCONTROL. If you have already installed SAP systems onother servers, we recommend that you use the same group ID (GID) for all sapsysand R3GROUP groups in the systems landscape. To obtain the group ID (GID) for



http://service.sap.com/~form/handler?_APP=01100107900000000342&_EVENT=REDIR&_NNUM= 83292&_NLANG=en&_NVERS=0

http://service.sap.com/~form/handler?_APP=01100107900000000342&_EVENT=REDIR&_NNUM=863821&_NLANG=en&_NVERS=0



R3GROUP on another IBM i server in your landscape, enter the command DSPUSRPRFUSRPRF(R3GROUP) and scroll down until you see the value for “Group ID number”.

Installation

1. Log on with user profile QSECOFR or a user profile with equivalent special authorities.

Note

This user is required for the installation.

End of the note.

2. To start a PASE interactive terminal session enter the command

CALL PGM(QP2TERM)

3. Make the directory that contains SAPCAR and the archive SAPHOSTAGENT<…>.SARyour current directory using the following command:

cd /tmp/hostctrl

4. Decompress the archive SAPHOSTAGENT<…>.SAR with the SAPCAR tool using thefollowing command:

./SAPCAR -xvf SAPHOSTAGENT<…>.SAR

5. To install SAPHOSTCONTROL enter the following command:

saphostexec –install –gid <gid>

Note

If you have already installed SAP systems on other servers, we recommend that youuse the same group ID (GID) for all sapsys or R3GROUP groups in the systemlandscape. To do this, enter your landscape system gid into <gid> on the abovecommand. If you want the SAPHOSTCONTROL installation to generate a new groupID, enter the command saphostexec –install instead.

End of the note.

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

Note

If it did not already exist, R3GROUP was created during the installation. Even thoughthe SAPHOSTAGENT does not require special authorities, we recommend that yougrant the required authorities for system API’s that need to be authorized for userprofile R3GROUP for your SAP system now. For more information, see SAP Note175852.

End of the note.

http://service.sap.com/~form/handler?_APP=01100107900000000342&_EVENT=REDIR&_NNUM=175852&_NLANG=en&_NVERS=0



ResultYou 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 hostmode)

Note

The installed programs are automatically started when the host is booted. OnMicrosoft Windows hosts, this is done by the services SAPHostControl andSAPHostExec. On UNIX hosts the automatic start is ensured by the startup scriptsapinit, which starts the required executables. On IBM i, the programs are startedby the auto start job SAPINIT in subsystem QUSRWRK, which is configured duringthe installation.

Directory /usr/sap/tmp, which is usually used by SAPOSCOL for loggingpurposes, will not be created during the installation of SAPHOSTCONTROL. If thedirectory does not exist as the outcome of another SAP installation, SAPOSCOL willwrite its logfiles to directory /tmp.

End of the note.

UpgradeIf 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 asdescribed above, and extract the archive into a temporary directory.

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

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

Upgrade Under UNIX


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


Upgrade Under IBM i


Log on with user profile QSECOFR or a user profile with equivalent special authoritiesand start a PASE interactive terminal session by entering the command CALLPGM(QP2TERM).



Switch to the temporary directory used for extracting SAPHOSTAGENT.SAR and runthe command saphostexec -upgrade.


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

saphostexec -uninstall

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

installation_saphostagent

Documents