Show TOC

Procedure documentationStarting and Stopping SAP NetWeaver Management Agents Locate this document in the navigation structure


Always stop and restart an SAP NetWeaver management agent if you have made changes to its configuration file SAPCCMSR.INI or to its profile file, since these files are only read when the agent is started.

When you start and stop the host agent, the operating system collector SAPOSCOL is also started and stopped.


Microsoft Windows

To start or stop the agent, start or stop the corresponding service. The name of the service depends on the type of agent:

Agent Type


Instance agent

SAP<SysID>_<instance number>

Host agent



Start or stop the agent by executing the following commands:

Agent Type

Command for Starting/Stopping the Agent

Instance agent

Call the sapcontrol script with the following parameters:

sapcontrol -nr <instance number> -function StopService

sapcontrol -nr <instancenumber> -function StartService

Host agent

Call saphostexec directly with the following parameter:

saphostexec -restart

If necessary, you can perform the stopping and starting of the agent in two commands, by calling saphostexec directly with the following parameters:

saphostexec -stop

saphostexec -restart

Note Note

saphostexec is at the following path: /usr/sap/hostctrl/exe

To check the current status of saphostexec, use the command saphostexec -status.

End of the note.

All Agents of the Host

If you want to start or stop all SAP NetWeaver management agents on a host, call the sapinit script with the following parameters:

sapinit stop

sapinit start

Note Note

The command sapinit stop also shuts down all instances on the relevant host, since the command is mainly used for the shutdown of the host.

In the same way, sapinit start starts the instances on the host, although only if the profile parameter Autostart=1 is set for this instance.

End of the note.

Depending on the type of UNIX, the sapinit start script is at the following path:

  • Linux: /etc/init.d/

  • Solaris /etc/init.d

  • HP-UX (True64): /sbin/init.d

  • AIX: /etc/rc.d/init.d