Tools

Agent servers

Agent server programs are Unix daemon like processes which are running in background and support the MyARM agent in configuring components and delivering the measured ARM data to its final database:

myarmfiled

program which collects transaction measurements from instrumented applications using flat files.

myarmtcpd

program which receives transaction measurements using TCP/IP sockets.

These agent server daemons can be controlled by the myarmservcmd command. With this command they can be stopped or instructed to flush their caches to the configured database, etc.

Configuration

In this section common agent server configuration properties are described. Agent server daemons are normally executed in background and in a Unix environment the following properties can be specified for all agent servers to configure its behaviour:

<component>.cmd.enable

enables or disables the command TCP channel for the appropriate agent server.

<component>.cmd.max_clients

defines the maximal number of TCP clients. Default is 1.

<component>.cmd.host

defines the host/interface where the daemon listens for incoming command connections. Default host is localhost.

<component>.cmd.port

specifies the command TCP channel port to use.

<component>.group

defines the group under which the agent server should be executed. If the agent server is started under the super-user (root) it can changes its group identity to the here configured group. For example a myarm group.

<component>.pidfile

defines the file where the appropriate agent server writes its process id to.

<component>.user

defines the user under which the agent server should be executed. If the agent server is started under the super-user (root) it can changes its user identity to the user configured here. For example a myarm user.

Agent servers as a Windows service

Under Windows it is possible to start the agent servers as a Windows service. To support Windows services the following command line options are available:

--install

installs the server agent as a Windows service.

--uninstall

uninstalls a previously installed the server agent.

--run

runs the server agent as a Windows service. This option should not be used manually. It is used to start the service through the Windows service management interface.