Commit b8c57c20 authored by Rob Riepel's avatar Rob Riepel
Browse files

Improved documentation

parent 1f7ce189
00DEV
bestest
pdns.conf*
......@@ -2,15 +2,17 @@
Contents
========
* Introduction
* Collecting and Summarizing Host Metrics
* Answering DNS Queries
* TTLs and MXes
* Configuring the poller
* The Load-Balanced Client Daemon
* Site-Specific Configuration
* Installation
* Conclusion
* [ Introduction ] (#introduction)
* [ Collecting and Summarizing Host Metrics ] (#collecting-and-summarizing-host-metrics)
* [ Answering DNS Queries ] (#answering-dns-queries)
* [ TTLs and MXes ] (#ttls-and-mxes)
* [ Configuring the poller ] (#configuring-the-poller)
* [ The Load-Balanced Client Daemon ] (#the-load-balanced-client-daemon)
* [ Site-Specific Configuration ] (#site-specific-configuration)
* [ Installation ] (#installation)
* [ PowerDNS Configuration ] (#powerdns-configuration)
* [ Starting the poller and PowerDNS ] (#starting-the-poller-and-powerdns)
* [ Conclusion ] (#conclusion)
Introduction
......@@ -167,8 +169,9 @@ Configuring the poller
bar.stanford.edu 10 www
baz.stanford.edu 5 quux www(.01)
# default TTL = 0 seconds; top slice - see the poller POD; XXX
# default MX = none;
# default TTL = 0 seconds
# default MX = none
# top slice - see poller documentation for "top-n"
group TTL top slice MX
############ ##### ######### ##################
......@@ -210,6 +213,46 @@ Installation
Use make(1) with the included Makefile to install the lbbe and poller programs
along with their dependencies.
PowerDNS Configuration
======================
Configure PowerDNS to use lbbe by adding (or changing) the following lines
in pdns.conf (usually found in /etc/powerdns or /etc/pdns):
# only run one copy of lbbe
distributor-threads=1
# add the pipe backend and set the pipe command
launch+=pipe
pipe-command=/usr/sbin/lbbe
# send queries for the load balancing domain to the pipe backend
pipe-regex=best\.stanford\.edu$
Starting the poller and PowerDNS
================================
The poller writes host names and weights to a file that lbbe uses to
determine which host names to pass out in response to queries. Therefore
it needs to be started and complete its first polling run before PowerDNS
or lbbe starts. To start the poller, simply run it and redirect its output
to a log file.
/usr/sbin/poller > /var/log/poller.log 2>&1
Use your system init system and/or a file detection loop to delay pdns
startup until the poller results exist. Here's an example file detection
loop:
while true ; do
[[ -s /var/lib/poller/lb ]] && exec pdns_server
echo lbDNS - no poller results yet, sleeping for 1 second ...
sleep 1
done
Conclusion
==========
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment