NAME
fair.conf - configuration file for the carrousel and transponder daemons
DESCRIPTION
Debug (bool, false)
Runs the program in debug mode: it will not detach, it will print
status updates very frequently, it will print extra diagnostic
messages to stderr.
DropPrivs (bool, true)
The program will switch to a different uid/gid after obtaining
root-only resources. See also the UserID and GroupID variables.
WorkerService (string, smtp) *
This is the service on which the worker nodes offer the service
that is being balanced. Typically this is the service of another
daemon, e.g. Postfix. The transponder daemon also uses this as
the datagram source service for its status updates.
BalancerService (string, smtp) *
The stream service on which the carrousel daemon listens for
incoming connections. These connections will be put through to
one of the worker nodes.
TransponderService (string, rlp) *
The carrousel daemon listens on this service for status update
datagrams from the transponders. See also the AllowUDP variable.
PingInterval (time, 0.1 seconds)
How often the transponder sends an update to each carrousel. So,
if two carrousels are configured and the interval is 0.1 seconds,
that transponder sends 20 packets every second.
PingTimeout (time, 0.5 seconds)
After this period has elapsed without receiving any status update
packets from the transponder, this host is considered dead.
IdleTimeout (time, 600.0 seconds)
The connection is terminated if neither party has sent something
for this many seconds. For SMTP connections this would have to be
at least 600.0 seconds, see RFC 2821 section 4.5.3.2.
ConnectTimeout (time, 1.0 seconds)
When connecting to a worker node, abort after this many seconds
have elapsed and no connection is established.
ConnectAttempts (integer, 3)
When putting through a connection fails, the carrousel will
attempt to contact other worker nodes. It will give up after this
many tries.
BenchPeriod (time, 5.0 seconds)
If a connection to a worker node fails it is excluded from new
connections for this many seconds.
TrailPeriod (time, 60.0 seconds)
When a connection is finished, pretend it lasted this many
seconds more for load calculation purposes.
Hysteresis (integer, 0)
Add an advantage to the last used worker node so that it gets
selected in preference of others.
MaxCapacity (integer, 100)
When sending update packets, the capacity of the worker node
measured in terms of concurrent connections. This number is
adjusted for the current load average before sending it to the
carrousel nodes.
MaxBurst (integer, 65536)
Ringbuffer size for load balancer nodes.
MinBurst (integer, 1450)
If fewer than this many bytes are available in the ring buffer,
do not read anything but try to free up space first.
LocalTCP (bool, yes)
Only allow connections over the loopback interface. If this
option is set to "no", connections will be accepted on any
interface and on any address.
AllowUDP (extended regexp, ^)
Only datagram status packets that match this extended regular
expression are accepted. All other datagram packets are logged
and silently dropped. Once UDP packets are accepted from a
certain source, they are never matched against this regexp again.
SEE ALSO
carrousel(8), transponder(8)