Skip to main content


What is SAP Hostagent ?

Host agents perform several life-cycle management tasks, such as operating system monitoring, database monitoring, system instance control and provisioning.

  • Installed automatically during the installation of new SAP system instances with SAP kernel 7.20 or higher.
  • SAP Host Agent is upgraded automatically as part of the SAP system instance, when you patch or upgrade the SAP kernel.
  • You can also install and upgrade SAP Host Agent independently from an SAP system instance.
  • Host agent is started automatically while we restart by sapinst in unix and in windows it is done by window service SAPHostcontrol and SAPHostexec.

Feature Provided by SAP Hostagent: 

By using sap hostagent various external entity such as LAMA , SOLMAN , SAP MC interact with the system using webservice runtime.

  • SAP instance discovery and inventory

  • SAP instance control

  • Database monitoring and management

  • System or instance provisioning:

    • Hosting the infrastructure of SAP Landscape Virtualization Management (LVM), formerly known as SAP NetWeaver Adaptive Computing Controller (ACC)

    • Hosting software lifecycle (SL) tools interfaces

  • Operating system monitoring:

    • Using saposcol

    • Using Common Information Model (CIM) based infrastructures

  • IBM i-specific features:

    • Dynamically adopted authorization for SAP kernel 7.20 and higher

    • SAP ILE daemon (SAPILED)

    • SAP Database Performance Collector for IBM i

Executables that perform SAP hostagent task :-

User used





saphostcontrol -nr <instance> -function ListDatabases



saphostexec is a service or daemon

hosts are monitored using this service.

hostagent administration (i.e. installation and upgrade of hostagent)

Check Hostagent version

./saphostexec -version

Check Hostagent Status

./saphostexec -status

Restart Hostagent

./saphostexec -restart

Stop Hostagent

./saphostexec -stop

Start Sap hostagent by using host profile

/usr/sap/hostctrl/exe/saphostexec pf=/usr/sap/hostctrl/exe/host_profile


NA(standalone command that run in OS background)

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

Usage of virtual and physical memory

CPU utilization

Utilization of physical disks and file systems

Resource usage of running processes

Points to keep a note of :-

  • SAPHostControl should not be confused with sapstartsrv which runs under the <sid>adm user in the SAP system instance with the instance profile.
  • SAPHostControl contains the functionality of the previous CCMS agent SAPCCMSR, that is, the agent that monitors hosts. 
  • Is SAP Hostagent mandatory , short answer No! , but it is highly recommended by SAP and is installed automatically at multiple instances for example when diagnostic agent is installed or simply when kernel is installed.

SAP hostagent files :-

Work Dir : In unix and IBM , /usr/sap/hostctrl/work

In windows, %ProgramFiles%\SAP\hostctrl\work

these directory  also contains few configuration files CSMCONF : Start file of the hostagent that contains connection data for central monitoring system and SAPCCMS.INI : that contains extent to which plug-ins, log files, and SAPOSCOL information should be considered; this file is read when the agent is started

To display all files in working directory of SAP HOSTAGENT is RZ 21 , Display Technical Topology > Work directory of the agent

Log Dir : Created During runtime 

sapstartsrv_ccms.log : Log files for central system monitoring , subdirectory sapccmsr of the working directory 
sapstartsrv.log : Contains developer trace of sapstartsrv
dev_saphostexec : developer trace of saphostexec
dev_sapdbctrl : developer trace of sapdbctrl 

How to download latest SAP Hostagent?

Download the latest version SAPHOSTAGENT from service marketplace.



How to install SAP Hostagent independently ?

<download path > : where new sap host agent is kept the SAR file

logon as root user 

1. uncar that file 
move to  the executable file location of hostctrl /usr/sap/hostctrl/exe/

In windows , sapcar.exe -xvf \SAPHOSTAGENT<SPversion>.SAR 
Similarly in linux sapcar -xvf \SAPHOSTAGENT<SPversion>.SAR

2. perform install

saphostexec -install

3. Check status of sap hostagent

sahostexec -status

How to upgrade SAP Hostagent independently ?

<download path > : where new sap host agent is kept the SAR file

1. uncar that file 
move to  the executable file location of hostctrl /usr/sap/hostctrl/exe/

In windows , sapcar.exe -xvf \SAPHOSTAGENT.SAR -manifest SIGNATURE.SMF
Similarly in linux instead of sapcar.exe directly sapcar

2. perform upgrade 

saphostexec -upgrade

How to uninstall SAP Hostagent ?

Login as root user , /usr/sap/hostctrl/exe/saphostexec -uninstall

For more read :- SAP NOTE: 2219592 [You should continuously upgrade SAP Hostagent ]

Github link for RHEL SAP Hostagent [RHEL HOSTAGENT]




You might find these interesting

How to properly Start/Stop SAP system through command line ?

Starting/stopping an SAP system is not a critical task, but the method that most of us follow to achieve this is sometimes wrong. A common mistake that most of the SAP admins do is, making use of the 'startsap' and 'stopsap' commands for starting/stopping the system.  These commands got deprecated in 2015 because the scripts were not being maintained anymore and SAP recommends not to use them as many people have faced errors while executing those scripts. For more info and the bugs in scripts, you can check the sap note 809477.  These scripts are not available in kernel version 7.73 and later. So if these are not the correct commands, then how to start/stop the sap system?  In this post, we will see how to do it in the correct way. SAP SYSTEM VS INSTANCE In SAP, an instance is a group of resources such as memory, work processes and so on, usually in support of a single application server or database server with

sapstartsrv is not started or sapcontrol is not working

 What is sapstartsrv ? The SAP start service runs on every computer where an instance of an SAP system is started. It is implemented as a service on Windows, and as a daemon on UNIX. The process is called  sapstartsrv.exe   on Windows, and   sapstartsrv   on UNIX platforms. The SAP start service provides the following functions for monitoring SAP systems, instances, and processes. Starting and stopping Monitoring the runtime state Reading logs, traces, and configuration files Technical information, such as network ports, active sessions, thread lists, etc. These services are provided on SAPControl SOAP Web Service, and used by SAP monitoring tools (SAP Management Console,  SAP NetWeaver  Administrator, etc.). For more understanding use this link : How to check if it is working or not ? In case of linux , you can simply ps -ef | grep sapstartsrv In case of windows, you need

HANA System Replication - Prerequisites & Setup

Hey Folks! Welcome back to Hana high availability blog series. In our last blog we checked out operation & replication modes in hana system replication. If you haven't gone though that blog, you can checkout  this link In this blog we will be talking about the prerequisites of hana replication and it's setup. So let's get started. When we plan to setup hana system replication, we need to make sure that all prerequisite steps have been followed. Let's have a look at these prerequisites. HANA System Replication Prerequisites: Primary & secondary systems should be up & running HDB version of secondary should be greater than or equal to Primary database sever But, for Active/Active(read enabled config), HDB version should be same on both sites. System configuration/ini files should be identical on both sides Replication happe

ST03N : The chapter for all BASIS Admins

This blog is targeted to BASIS ADMINS Transaction for workload analysis statistical data changed over time are monitored using transaction code ST03 , now ST03N (from SAP R/3 4.6C) . With SAP Web AS 6.4 the transaction ST03 is available again. From time to time ST03 and ST03N has seen many changes but later in SAP NW7.0 ST03N has reworked in detail specially processing time is now shown in separate column. Main Use of ST03N  is to get detailed information on performance of any ABAP based SAP system. Workload monitor analyzes the statistical data originally collected by kernel. You can compare or analyze the performance of a single application server or multiple application server. Using this you start checking from the entire system and finding your way to that one application server and narrowing down to exact issue. By Default :- You see data of current day as default view , you can change the default view. Source of the image : Let's discuss the WORKLOAD MONITOR By D

How to resolve Common Error : Standard Template "sap_sm.xls" missing

Hey everyone, putting forward a common error we usually face when we have “ Excel inplace” functionality enabled in our SAP system. This error occurs when validity of the signature of SAP standard templates expired or were incorrectly delivered via support packages. We can reproduce the error by doing as below.. Click on “spreadsheet” icon after any SAP ALV grid view of data is on screen to make this data to export into excel directly from SAP.

HANA hdbuserstore

The hdbuserstore (hana secure user store) is a tool which comes as an executable with the SAP Hana Client package. This secure user store allows you to store SAP HANA connection information, including user passwords, securely on clients. With the help of secure store, the client applications can connect to SAP HANA without the user having to enter host name or logon credentials. You can also use the secure store to configure failover support for application servers in a 3-tier scenario (for example, SAP Business Warehouse) by storing a list of all the hosts that the application server can connect to. To access the system using secure store, there are two connect options: (1)key and (2)virtualHostName. key is the hdbuserstore key that you use to connect to SAP HANA, while virtualHostName specifies the virtual host name. This option allows you to change where the hdbuserstore searches for the data and key files. Note

SUM Tool : An Introduction

Let’s Discuss about the famous tool, that is asked in almost all the Basis and HANA interview and it is very easy to understand but a bit tricky. Tighten your seatbelts and Let’s understand in one go. SAP Technical Upgrade is a periodic project that is implemented across companies to upgrade their SAP system to the latest released version. Most of the upgrade activities are done by the technical team and the role of functional consultants is limited and mostly confined to regression testing What are the maintenance that are performed by help of SUM ? Release upgrade (major release change) System update (EHP installation) applying Support Packages (SPs) / Support Package Stacks applying Java patches correction of installed software information combine update and migration to SAP HANA (DMO: Database Migration Option) System Conversion from SAP ERP to SAP S/4HANA   First thing first , never confuse in these two things : Upgrade and Update. Updating SAP products is for applying support pac

SAP HANA System Replication - Operation Mode & Replication Mode

Hey Folks! Welcome back to Hana high availability blog series. In our last blog we checked out what is hana system replication and how it basically works. If you haven't gone through that blog, you can checkout link In this blog we will be talking about the replication modes and operation modes in hana system replication. So let's get started. When we setup the replication and register the secondary site, we need to decide the operation mode & replication mode we want to choose for replication. For now we won't focus on setting up replication as we'll cover it in our next blogs.  Operation Modes in Hana System Replication: There are three operation modes available in system replication: delta_datashipping, logreplay and logreplay_readaccess. Default operation mode is logreplay. 1. Delta_datashipping: In this operation mode initially one full data shipping is done as part of replication setup and then a delta data shipping takes place occasionally in addition to cont

Work Process and Memory Management in SAP

Let’s talk about the entire concepts that are related to memory when we talk about SAP Application. Starting with few basic terminologies, Local Memory :  Local process memory, the operating system keeps the two allocation steps transparent. The operating system does the other tasks, such as reserving physical memory, loading and unloading virtual memory into and out of the main memory. Shared Memory :  If several processes are to access the same memory area, the two allocation steps are not transparent. One object is created that represents the physical memory and can be used by various processes. The processes can map the object fully or partially into the address space. The way this is done varies from platform to platform. Memory mapped files, unnamed mapped files, and shared memory are used.  Extended Memory : SAP extended memory is the core of the SAP memory management system. Each SAP work process has a part reserved in its virtual address space for extended memory. You can set

Complete Guide : XPI Inspector Tool

Content of this blog :           What is an XPI Inspector Tool ? Why XPI Tool is used ? XPI standard URL How to check XPI Tool version ? How to Install/Update XPI version using TELNET How to Use XPI Tool ? References – SAP Notes What is XPI Inspector tool ?          -    XPI Inspector is a diagnostics web application developed by SAP that collects logs and debug traces from various PI components in a very simple way and is useful for SAP PI consultants, developers, and administrators to get more insights on an issue. Why XPI is used  – 1.  Used to collect traces and logs from Messaging system or XI module. 2. Used to collect the related information to solving the issues or improving the PI or PO systems’ performance. 3. Using XPI Inspector application you will be able to collect a lot of information about your system that will help you to learn about problems in the past, to analyze new and detect such at an early stage. 4. Performs certain number of configuration checks, such as SSL c