evmdaemon.conf(4) — File Formats

NAME

evmdaemon.conf − EVM daemon configuration file

SYNOPSIS

sourcedir          directory
authtimeout        time_seconds
synctimeout        time_seconds
portnum            port_number
start_sync         command
remote_connection bool_par
activity_monitor   {
                    name        detector
                    period      detect_period
                    threshold   detect_thold
                    holdoff     detect_delay
                   }
service            {
                    name    service_name
                    command service_command
                   }

DESCRIPTION

The EVM daemon configuration file, evmdaemon.conf, is a text file that contains commands used to configure and start the Event Manager. Any portion of a line from an unquoted number sign (#) to the end of line is a comment. Blank lines are ignored. The following commands are recognized:

sourcedir directory
Names the directory that should be searched for event template files. The default is /usr/share/evm/templates.

authtimeout time_seconds
Time to wait for a newly established client to respond to an authentication request. The default is 10 seconds.

synctimeout time_seconds
Time within which a synchronized client must achieve synchronization completing a connection request and subscribing for events. The default is 30 seconds.

portnum port_number
The port number for TCP communication with remote clients. If not specified, the evm port number found in /etc/services is used if present; otherwise the reserved default value of 619 is used.

start_sync command
The complete command line for programs that should be started as synchronized clients when the daemon starts. This command should be enclosed in double quotation marks (").

remote_connection bool_par
Determines the permission for connections through a remote TCP port. If bool_par evaluates to TRUE, remote connection is permitted. The default is not permitted. The bool_par parameter should be True or False.

activity_monitor
A parameter group that controls a daemon event monitoring facility. An activity_monitor definition consists of:

name detector
The type of detector controlled by the group parameters.

period detect_period
The size, in minutes, of a periodically sliding time window over which events will be counted.

threshold detect_thold
The number of events that will activate the monitor if counted in period.

holdoff detect_delay
The time delay, in minutes, after activation of the activity monitor occurs before monitoring is resumed. The evmreload command will reset the delay.

serviceDefines services that are available through the daemon. A service definition consists of the name of the service and the command line that will be invoked when this service is requested. User-defined services are not currently supported.

A service definition consists of:

name service_name
The name given to the service.

command service_command
The command to be invoked when this service is requested. This command should be enclosed in double quotation marks (").

The keywords described may be entered in a case-insensitive manner. The allowable strings and the minimum number of characters is shown in the following table. A minimum of zero (0) indicates that all characters are required.

Keyword	Minimum
activity_monitor	0
authtimeout	8
command	4
filterdir	7
holdoff	0
name	0
period	0
portnum	4
remote_connection	0
service	7
sourcedir	7
start_sync	0
synctimeout	8
threshold	0

The activity monitor detectors recognized, and the action taken when the monitor is activated are the following:

Detector	Action
event_count	post an event to alert the system administrator

EXAMPLES

This is an example of an EVM daemon configuration file that does the following:

1.Specifies that event templates are found in the directory /usr/share/evm/templates.

2.Starts the EVM Logger and the EVM Channel Manager as synchronized clients when the daemon is started.

3.Defines a service available through the EVM daemon.

4.Establishes an activity monitor that will alert the system administrator if 500 events occur in any 10 minute span. Once the system administrator has been alerted, the activity monitor will remain dormant for four hours.

5.Disables connections from remote hosts.

# Event template directory:
sourcedir       "/usr/share/evm/templates"
# Start the EVM Logger as a synchronized client:
start_sync      "/usr/sbin/evmlogger \
                        -o /var/run/evmlogger.info \
                        -l /var/evm/adm/logfiles/evmlogger.log"
# Start the EVM Channel Manager as a synchronized client:
start_sync      "/usr/sbin/evmchmgr \
                        -l /var/evm/adm/logfiles/evmchmgr.log"
# Event retrieval service definition:
service         { name          event_get
                  command       "/usr/sbin/evmget_srv"
                }
# Set up an activity monitor.
activity_monitor {
        name        event_count # currently the only supported monitor
        period      10           # count over a 10 minute period
        threshold   500          # perform action after 500 events
        holdoff     240          # wait 4 hours before resuming
}
# Disable remote communication (set following to "true" to enable)
remote_connection       false

FILES

/etc/evm.authLocation of the EVM authorization file.

/etc/evmdaemon.conf
Location of the EVM daemon configuration file.

/etc/servicesDefinition of the sockets and protocols used for Internet services.

Museum