--- projects/cms/source/server/build/etc/system.conf	2001/01/18 12:06:07	1.3
+++ projects/cms/source/server/build/etc/system.conf	2003/02/23 12:45:21	1.70
@@ -5,41 +5,455 @@
 # configuration system has this file as its 
 # root of configuration
 #
+# This is a working sample configuration, which
+# aims to provide a working "out of the box"
+# setup, aswell as a some example configuration.
+#
 # $Author: tdb $
-# $Id: system.conf,v 1.3 2001/01/18 12:06:07 tdb Exp $
+# $Id: system.conf,v 1.70 2003/02/23 12:45:21 tdb Exp $
+#
+# http://www.i-scream.org.uk/
+#
 
-# FilterManager configuration
+############################################################
+#### Configuration Files & Groups
+############################################################
 
-# The default port to listen for new host connections
+# All components, such as hosts, will take their configuration
+# as given in this file. Unless, that is, they have an extra
+# configuration file specified here, or they're in a group
+# that has a configuration file. If this is the case the extra
+# configuration will override what is given in this file.
+
+# We can define an extra configuration file for any component
+# of the system. This is done by specifying the following:
+#
+# config.component=someconfigfile.conf
+#
+# Component names will be defined in the documentation for
+# the component. An example is that a host component is
+# known by the name "Host.hostname" or "Host.ip".
+# It is also possible to use the wildcard "*" in a
+# hostname or IP address.
+
+# This defines that server.example.com has some extra
+# configuration in the file 'server.conf'.
+config.Host.server.example.com=exserver.conf
+
+# All webservers are placed in a group named 'www'.
+group.www=Host.www1.example.com;Host.www2.example.com
+# Then we define some extra config for them.
+config.www=webservers.conf
+
+# Our workstations are in their own subnet.
+group.workstations=Host.192.168.10.*;
+# They can have their own config too.
+config.workstations=workstations.conf
+
+# Any hosts not specified by now have the default
+# config as given in this file.
+
+# Another component of the system is the mySQL
+# database part of the server call the DBInterface.
+# This has it's own config so the passwords for the
+# mySQL database can be kept seperate.
+#config.mySQL=mySQL.conf
+
+
+############################################################
+#### Misc system-wide configuration
+############################################################
+
+# The ConfigurationProxy caches configuration for various
+# parts of the server. This setting defines how often, in
+# seconds, the proxy will check if the data it contains
+# is still valid.
+ConfigurationProxy.updateTime=60
+
+# The internal Queue's can be monitored. This specifies
+# the interval, in seconds, at which their state should
+# be monitored.
+Queue.MonitorInterval=15
+# The maximum size a Queue can be before items are
+# dropped when new ones arrive.
+Queue.SizeLimit=1000
+# And which items we should drop when the queue is full
+# and new items arrive. Choices are:
+# RANDOM - drop a random item from the queue
+# FIRST  - drop the first item from the queue
+# LAST   - drop the last item from the queue
+# DROP   - drop the new item from the queue
+Queue.RemoveAlgorithm=FIRST
+
+# The XMLCache caches data passing through the system.
+# This setting specifies the time, in seconds, at which
+# the caches contents will be rotated. In real terms
+# this means the minimum age at which an XMLPacket can
+# be before it is up for deletion from the cache.
+XMLCache.cleanupPeriod=30
+
+
+############################################################
+#### FilterManager configuration
+############################################################
+
+# The FilterManager accepts connections from hosts
+# upon startup. It provides them with configuration
+# and details of which filter to talk to. This setting
+# specifies which port (TCP) it listens on.
 FilterManager.listenPort=4567
 
-# The default port for Filter's to listen on
+# An Access Control List for the FilterManager. One
+# might consider something like this:
+#
+# FilterManager.ACL=DEFAULT:DENY;*.example.com:ALLOW
+FilterManager.ACL=DEFAULT:ALLOW
+
+
+############################################################
+#### Filter configuration
+############################################################
+
+# A Filter accepts data from hosts on both a TCP port
+# and a UDP port. They are specified here.
 Filter.UDPListenPort=4589
 Filter.TCPListenPort=4589
 
-# The name for the root filter
+# Filters contain plugins for checking the data passing
+# through them. This plugins do the job of "filtering".
+# This setting specifies the java package they're
+# contained in.
+Filter.PluginsPackage=uk.org.iscream.cms.server.filter.plugins
+# And the names of the plugins to be loaded.
+Filter.Plugins=TypeChecker;EnforceEssentialData;SourceChecker;KeyChecker
+
+# The special filter known as the "Root Filter" needs
+# a name within the system.
 RootFilter.name=root
-# Comment either of these (or delete them) and
-# that interface won't be started
-RootFilter.realtimeInterfaceName=realtimeclients
+
+# Every Filter, except the root, needs a parent to
+# send their data to. This is usually the root filter,
+# although in more complex setups it might be another
+# filter - giving a tree structure.
+Filter.parentFilter=root
+
+# A Filter can accept data through UDP, TCP, or from
+# an upstream Filter (CORBA). These methods can be
+# individually turned of on a filter. The default
+# is to have them all on.
+# (comment or set to 0 to disable)
+Filter.ActivateTCPReader=1
+Filter.ActivateUDPReader=1
+Filter.ActivateCORBAReader=1
+
+# We can also specify Access Control Lists for the
+# TCP and UDP inputs of the Filters. One might want
+# something restrictive like this:
+#
+# Filter.TCPACL=DEFAULT:DENY;*.example.com:ALLOW
+# Filter.UDPACL=DEFAULT:DENY;*.example.com:ALLOW
+Filter.TCPACL=DEFAULT:ALLOW
+Filter.UDPACL=DEFAULT:ALLOW
+
+# A Filter plugin called the SourceChecker verifies
+# that packets come from permitted hosts. It is
+# given an ACL to check the hosts against. A possible
+# ACL might be:
+#
+# Filter.SourceCheckerPluginACL=DEFAULT:DENY;*.example.com:ALLOW
+Filter.SourceCheckerPluginACL=DEFAULT:ALLOW
+
+# Enforce that hosts use the key based authentication.
+# (comment or set to 0 to disable)
+Filter.EnforceHostAuth=1
+
+# Length of keys to use in authentication.
+Filter.KeyLength=15
+
+
+############################################################
+#### Root filter interfaces configuration
+############################################################
+
+# The Root FIlter can send data to various upstream
+# data processors. There are two of these at present
+# in the server - the DBInterface and the ClientInterface.
+# Their component names are given here as defined below.
+# (the DBInterface is switched off - commented - by default)
 #RootFilter.dbInterfaceName=database
+RootFilter.realtimeInterfaceName=realtimeclients
 
-# The port for the client interface to listen on
+
+############################################################
+#### Client interface configuration
+############################################################
+
+# The client interface listens for connections from clients
+# on a TCP port. It is specified here.
 ClientInterface.listenPort=4510
+# The component name for the Client Interface. This should
+# match the name specified to the Root Filter above.
+ClientInterface.name=realtimeclients
 
-# The default parent filter (should almost always be the same as Filter.rootFilter)
-Filter.parentFilter=root
+# The Client Interface has two channels, control and data.
+# Each of these can have an ACL for allowing connections.
+# As per previous examples in this configuration file they
+# could be set restrictively, but we'll leave them open
+# by default
+ClientInterface.TCPControlChannelACL=DEFAULT:ALLOW
+ClientInterface.TCPDataChannelACL=DEFAULT:ALLOW
 
-# The default filter for a new host
-Host.filter=filter1
 
-# The default update times for a new host
-Host.UDPUpdateTime=5
+############################################################
+#### Database interface configuration
+############################################################
+
+# The name for the Database Interface. This should match
+# the name given to the Root Filter.
+DBInterface.name=database
+
+
+############################################################
+#### Host Configuration
+############################################################
+
+# A host can use any filter. We'll set the default filter
+# for all hosts to be 'filter1'. This can be a list.
+Host.filter=filter1;
+
+# Hosts send data every UDPUpdateTime, in seconds, and then
+# perform a heartbeat every TCPUpdateTime, in seconds.
+Host.UDPUpdateTime=10
 Host.TCPUpdateTime=60
 
-# Plugin Information
-Filter.PluginsPackage=uk.ac.ukc.iscream.filter.plugins
-Filter.Plugins=EnforceEssentialData
+# We can run service checks on a host. The java package
+# which contains them is specified here.
+Host.serviceChecksPackage=uk.org.iscream.cms.server.filter.plugins
 
-# mySQL Details
-config.mySQL=mySQL.conf
+
+############################################################
+#### Monitor Configuration
+############################################################
+
+# Monitors allow data to be watched for possible problems.
+# This setting specifies which java package they're in.
+Monitor.PluginsPackage=uk.org.iscream.cms.server.client.monitors
+# And which ones should be loaded.
+Monitor.Plugins=CPU;Load;Process;Disk;Memory;Swap;Services;\
+                Heartbeat;Queue;UserCount;WebFeeder;
+
+# Alerts timeout after a given time in seconds and go up
+# to the next level. These can be overridden for monitors
+# on an individual basis.
+Monitor.alertTimeout.NOTICE=60
+Monitor.alertTimeout.WARNING=900
+Monitor.alertTimeout.CAUTION=1800
+Monitor.alertTimeout.CRITICAL=3600
+
+## Threshold values
+#
+# Here we specify the threshold for each monitor. When
+# a threshold is broken an alert is raised. If the
+# UPPER threshold is broken the alertTimeout values
+# given above are halved to make the alert escalate
+# quicker.
+
+# CPU monitor threshold values
+Monitor.CPU.threshold.LOWER=90
+Monitor.CPU.threshold.UPPER=95
+
+# Load monitor threshold values
+Monitor.Load.threshold.LOWER=10.0
+Monitor.Load.threshold.UPPER=20.0
+
+# Process Count threshold values
+Monitor.Process.threshold.LOWER=500
+Monitor.Process.threshold.UPPER=1000
+
+# Memory monitor threshold values
+Monitor.Memory.threshold.LOWER=80
+Monitor.Memory.threshold.UPPER=90
+# Whether to include 'cache' in the 'free' value
+# (1 is true, anything else is false)
+Monitor.Memory.useCacheAsFree=1
+
+# Swap monitor threshold values
+Monitor.Swap.threshold.LOWER=80
+Monitor.Swap.threshold.UPPER=90
+
+# UserCount monitor threshold values
+Monitor.UserCount.threshold.LOWER=100
+Monitor.UserCount.threshold.UPPER=200
+
+# Disk monitor threshold values
+Monitor.Disk.threshold.LOWER=90
+Monitor.Disk.threshold.UPPER=95
+# Thresholds given are PERCENTAGE or VALUE
+# where PERCENTAGE is a percentage of disk in use
+# and VALUE is an absolute value of space free
+Monitor.Disk.thresholdMeasure=PERCENTAGE
+
+# Queue monitor threshold values
+Monitor.Queue.threshold.LOWER=50
+Monitor.Queue.threshold.UPPER=80
+# Thresholds given are PERCENTAGE or VALUE
+# where PERCENTAGE is a percentage of the queue in use
+# and VALUE is an absolute value of free space
+Monitor.Queue.thresholdMeasure=PERCENTAGE
+
+# Services monitor threshold values
+# 
+# THE SERVICES MONITOR USES A HACK
+# WHEREBY IT USES THE SERVICE STATUS
+# AS THE THRESHOLD LEVEL. THIS SHOULD
+# BE LOOKED AT!
+#
+# how many times we should be at the highest level before
+# we go to a FINAL alert
+Monitor.Services.reachFINALcount=5
+
+# Heartbeat threshold values
+# these are values in seconds from when the heartbeat
+# was *expected* to arrive (ie. last + hearbeat period)
+Monitor.Heartbeat.threshold.LOWER=180
+Monitor.Heartbeat.threshold.UPPER=300
+# this is how often we will run a "check" of heartbeats
+Monitor.Heartbeat.checkPeriod=50
+# how many times we should be at the highest level before
+# we go to a FINAL alert
+Monitor.Heartbeat.reachFINALcount=5
+# list of hosts we expect to have at startup
+# this ensures we notice hosts that aren't running, not
+# just those that have gone down recently.
+#Monitor.Heartbeat.initialHosts=importantserver.example.com;myserver.example.com
+
+
+############################################################
+#### Alerter Configuration
+############################################################
+# The following variables are understood by ALL alerters
+# for messages. They will be substituted for their
+# appropriate value.
+#
+# %level%               - the alert level (eg, WARNING)
+# %threshold%           - the threshold broken (eg, LOWER)
+# %source%              - the source of the alert (eg, raptor.ukc.ac.uk)
+# %value%               - the value reached (eg, 95)
+# %thresholdValue%      - the value of the threshold broken (eg, 90)
+# %attributeName%       - the attribute that has caused the alert (eg, CPU User)
+# %timeTillNextAlert%   - the time the next alert will be sent out
+# %timeSinceFirstAlert% - the time elapsed since the first alert for this problem
+# %timeOfFirstAlert%    - the time the first alert was sent
+#
+
+# The java package containing the alerters
+Alerter.PluginsPackage=uk.org.iscream.cms.server.client.alerters
+# And the names of the ones to activate
+# You might want to turn them all on, but we only activate
+# two basic ones by default.
+# Alerter.Plugins=EMail;IRC;WebFeeder;Logging;
+Alerter.Plugins=WebFeeder;Logging;
+
+# Configuration for the EMail alerter
+# The level alerts have to bypass to be e-mailed out
+Alerter.EMail.level = WARNING
+# A list of people to send alerts to
+Alerter.EMail.destList = me@example.com
+# The sender of the e-mail
+Alerter.EMail.sender = me@example.com
+# The SMTP server to send alerts to
+Alerter.EMail.smtpServer = smtp.example.com
+# The subject line of the e-mail
+Alerter.EMail.subject = i-scream alert: %level% alert on %source% for %attributeName%
+# The message in the e-mail
+Alerter.EMail.message = The i-scream distributed central monitoring system has\nraised a %level% alert for the host %source%.\n\nThe value for %attributeName% of %value% has exceeded the\n%threshold% threshold value of %thresholdValue%.\n\nThis alert was originally raised at %timeOfFirstAlert%,\nwhich was %timeSinceFirstAlert% ago.\n\nThe next alert (should one occur) will be sent in %timeTillNextAlert%.
+
+# Configuration for the IRC alerter
+# The level alerts have to bypass to be sent
+Alerter.IRC.level = OK
+# The IRC server name
+Alerter.IRC.IRCServer = irc.example.com
+# and it's port
+Alerter.IRC.IRCPort = 6667
+# A list of nicks to try and be
+Alerter.IRC.nickList = iscreamBot;_iscreamBot;i-screamBot
+# Username to be
+Alerter.IRC.user = i-scream
+# Responses to CTCP prods
+Alerter.IRC.comment = i-scream alerting bot (based on PircBot)
+Alerter.IRC.finger = i-scream alerting bot (based on PircBot)
+# Channel to join
+Alerter.IRC.channel = #i-scream
+# Message to use when sending an alert
+Alerter.IRC.message = %level%: %attributeName% on %source% has passed %threshold%(%thresholdValue%) threshold with %value% - time till next alert (should one occur), %timeTillNextAlert%
+# How long to wait before reconnecting
+Alerter.IRC.reconnectDelay = 30
+# Notice to send when starting up
+Alerter.IRC.startupNotice = i-scream alerting bot activated 
+# Commands the bot will recognise
+Alerter.IRC.stopCommand = stop alerts
+Alerter.IRC.startCommand = start alerts
+Alerter.IRC.lastAlertCommand = last alert
+Alerter.IRC.joinCommand = join
+Alerter.IRC.nickChangeCommand = nick
+Alerter.IRC.statCommand = statistics
+Alerter.IRC.uptimeCommand = uptime
+Alerter.IRC.timeSinceLastAlertCommand = time since last alert
+Alerter.IRC.versionCommand = version
+Alerter.IRC.helpCommand = help
+# Message to send when the bot is addressed and
+# doesn't understand the command
+Alerter.IRC.rejectMessage = sorry, I don't understand your request
+
+# Configuration for the Logging Alerter
+# This alerter writes alerts to the i-scream logfile.
+# The level alerts have to bypass to be logged
+Alerter.Logging.level = WARNING
+# The message to use when logging the alert
+Alerter.Logging.message = %level%: %attributeName% on %source% has passed %threshold%(%thresholdValue%) threshold with %value%
+
+
+############################################################
+#### WebFeeder Configuration
+############################################################
+
+# The WebFeeder drops alerts and latest data in to a
+# directory for the web interface to use. It is essentially
+# the link between the web interface and the server.
+
+# Set these to something to tell the WebFeeder to drop
+# latest data, alerts, or both. Comment themt o disable.
+WebFeeder.latestActive = true
+WebFeeder.alertActive = true
+
+# We can make the WebFeeder only drop alerts that go
+# past a certain level. The default is "OK", which makes
+# all alerts get passed on.
+Alerter.WebFeeder.level = OK
+
+# The WebFeeder cleans out old and stale alerts when it
+# performs a check. This setting is the period, in seconds,
+# at which a check happens.
+WebFeeder.checkPeriod = 120
+
+# Delete alerts older than this, in seconds.
+WebFeeder.alertDeleteOlderThan = 300
+
+# Data will be dropped to a subdirectory (specified
+# below) of this directory.
+WebFeeder.rootPath = /web/i-scream
+
+# SubDir is the directory below rootPath which latest
+# data will be placed in. Below that a directory will
+# be created with the machine name, and a file named
+# FileName (specified here) will be created containg
+# the data.
+WebFeeder.latestSubDir = latest
+WebFeeder.latestFileName = latest_data
+
+# As above, but for the alerts.
+WebFeeder.alertSubDir = alert
+WebFeeder.alertFileName = alert_data
+
+
+############################################################