The config directory.

The configuration directory - configdir

Introduction

The configdir is the place where ESM stores it's configuration. Usually the configdir /usr/local/esm/etc however you may change that with command line options. Each monitor and sender has it's own configuration file. When esmd starts up it reads each file in configdir and adds the monitors and senders configured.

Adding plugins.

Adding a plugin is very easy. There are only 3 things you have to specify.

```
title <string>
```
The title of the plugin.

```
cmd <string>
```
The command to execute to run the plugin. esmd will get the command and run it with /bin/sh -c "<string>" Note that the plugin path (usually /usr/local/esm/plugins, changable via the Makefile) will be the first part of the search path.

```
monitor
```
Specifies that the plugin is a monitor.

dmonitor

Specifies that the plugin is a daemon monitor.

```
sender #
```
Specifies that the plugin is a sender. # is the priority of the sender. Each priority group will be tried one at a time. All senders of priority 1 will be tried first, then 2 then 3 etc.

Now that you have your plugin config file just save it with any name, althrough I recomend logical names so you don't go insane when you update things. :)

The esm.conf file.

The file esm.conf is special. If a config file is named that a different set of rules apply. esm.conf is used to set general options like the update interval. However the format of esm.conf is the same as any other config file.

```
updateinterval #
```
The interval between updates. On each update each monitor is run, a system report is made and the results are sent back to you. Defaults to 10m

```
monitortimeout #
```
The timeout on monitors. After # seconds the monitor is killed if it hasn't exited already. Defaults to 1m

```
sendertimeout #
```
Same as above but for senders. Defaults to 2m

```
module_kill_signal_interval #
```
When a plugin is killed esmd sends it a few signals. First SIGINT, then SIGHUP, then SIGKILL. Between each signal esmd waits so the plugin has a chance to cleanly exit. module_kill_signal_interval specifies how long esmd waits. Defaults to 5s

Example monitor config file

title ESM Date
cmd esmdate
monitor

Example sender config file

title Email Sender
cmd emailsender
sender 1

Example esm.conf file

updateinterval 1m
monitortimeout 10s
sendertimeout 10s
module_kill_signal_interval 3s

Index