Showing posts with label Hostagent. Show all posts

General Information:

It is an agent that can accomplish several life cycle management tasks, such as operating system monitoring, DB monitoring, system instance control and provisioning.

It is installed automatically when we install a new system of Netweaver 7.20 or higher version.

It upgrades automatically when we upgrade the system or when we patch or upgrade the kernel of existing system.

We can also upgrade the host agent individually.

The host agent starts automatically when we boot the system and it is performed using sapinst script in UNIX.

Information about different files of SAPHOSTAGENT:

With the help of host agent the SOLMAN/LVM/SAP MC … collects information of the system to monitor the system status and these are connected to host agent of a particular system using a web service Runtime.

The functionalities of host agent are performed by using the following executables.
1.      Sap Host Control
2.      Sap Host Exec
3.      Saposcol

Location of executables:
               UNIX - /usr/sap/hostctrl/exe

Functionalities of Different Executables:

SAPHOSTEXEC:

It runs under privileged user account such as root in UNIX.
It is used for host agent installation and upgrade purposes.

SAPHostControl:
               It runs under the sidadm user.
               It is the agent that monitors hosts.

Saposcol:
               It runs independent of instances and we have exactly one agent for each host.
               The data collected by Saposcol is placed in a shared memory which makes the information available to all instances in a host and to various applications.
It collects the information of following OS resources such as
                              Physical and virtual memory usage
                              CPU utilization
                              Utilization of physical disks and file systems.
                              Resources usage of running processes.

Profile file:

               It contains all the parameters required to proper functioning of host agent and it is identified as host_profile file.
               It is available under executable directory.

Log Files:

               The following files available under work directory.
               Sapstartsrv_ccms.log – log file for central monitoring and it is stored under sapccmsr directory.
               Sapstartsrv.log – developer trace of sapstratsrv.
               Dev_saphostexec – developer trace of hostexec.
               Dev_sapdbctrl – developer trace of sapdbctrl.

Prerequisites

You have downloaded the required target release version of the SAPHOSTAGENT<SP-version>.SAR archive as described in Downloading the SAPHOSTAGENT Archive.

Procedure

  1. Log on as a user with the required authorization:
    WindowsAs a member of the local Administrators group
    UNIXAs a user with root authorization
    IBM iAs a user profile with special authorities *SECADM and *ALLOBJ, for example as user profile QSECOFR.
  2. IBM i only: Enter the command CALL PGM(QP2TERM) to start a PASE interactive terminal session.
  3. Copy the downloaded SAPHOSTAGENT<SP-version>.SAR archive to a temporary directory, for example:
    Windowsc:\temp\hostagent
    UNIX,
    IBM i
    /tmp/hostagent
  4. Extract the SAPHOSTAGENT<SP-version>.SAR archive using SAPCAR.
    Take SAP Note 212876 Information published on SAP site 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 <path to temporary directory>\SAPHOSTAGENT<SP-version>.SAR -manifest SIGNATURE.SMF
    UNIX,
    IBM i
    /<path to SAPCAR>/sapcar -xvf <path to temporary directory>/SAPHOSTAGENT<SP-version>.SAR -manifest SIGNATURE.SMF
    Among others, the archive contains the saphostexec program.
  5. Perform the upgrade by running the following command:
    Windows
    <path to temporary directory>\saphostexec.exe -upgrade
    recommendation
    You can use the additional parameter -verify to verify the content of the installation package against the SAP digital signature
    UNIX,
    IBM i
    /<path to temporary directory>/saphostexec -upgrade
    recommendation
    You can use the additional parameter -verify to verify the content of the installation package against the SAP digital signature
    The progress of the upgrade is displayed on the command line.
  6. After the upgrade has finished successfully, you can check the version of the upgraded host agent by executing the following command from the directory of the SAP Host Agent executables:
    Windows%ProgramFiles%\SAP\hostctrl\exe\saphostexec.exe -version
    UNIX
    • If you are logged on as a user with root authorization, the command is as follows: /usr/sap/hostctrl/exe/saphostexec -version
    • If you are logged on as a member of the sapsys group, for example <sapsid>adm, the command is as follows: /usr/sap/hostctrl/exe/hostexecstart -version
    IBM i/usr/sap/hostctrl/exe/saphostexec -version
  7. IBM i only: Leave the PASE interactive terminal session using function key F3

Next Steps

Post-requisites:
You can now delete the temporary directory with all its content.
Copyright © 2013 VENKAT SAP BASIS