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)

Debian GNU/Linux                                   2005-01-27                                       fair.conf(5)