PowerDNS Web Control Panel

Features:

• Get aggregate statistics of all PowerDNS instances, split out by authoritative and recursive servers
• Centrally & individually purge caches of possibly outdated data
• Centrally & individually search log files for troubleshooting purposes
• Monitor patch levels of all servers
• Centrally & individually deploy versions of the software
• Centrally & individually start, restart and stop instances
• View configuration details
• View and edit zone contents

• Python 2.6 or Python 2.7
• PowerDNS Authoritative 3.4-pre
• PowerDNS Recursor 3.6-pre
• Graphite
• PostgreSQL 8.3 or newer, or MySQL 5.5 or newer
• Cron

• Chrome 33+
• Firefox 24.3+
• Internet Explorer 9+
• Safari 7+

How it all hangs together:

• PowerDNS Authoritative Server and PowerDNS Recursor both publish data, and accept commands, via a JSON-powered, RESTful interface. This interface is not specific to 'pdnscontrol', and can be used by everyone. Commands allow for full zone editing, removal etc.
• We provide a Flask-based webapp through which you can query, manipulate and configure your PowerDNS instances through the JSON interface
• A separate program, pdnsmgrd, can stop, start and restart your PowerDNS instances remotely. It can also proxy API requests to multiple servers, and provides SSL encryption
• A separate program, pdns2graphite, stores all metrics in graphite. The webapp meanwhile refers to graphite graphs in its user interface
• pdns2graphite can query the webapp for configuration details

Flask-based web app.

Make sure you have MySQL, PostgreSQL and Python development libraries available, possibly like this:

sudo apt-get install libpq-dev libmysqlclient-dev python-dev

Then:

virtualenv venv-pdnscontrol
. ./venv-pdnscontrol/bin/activate
pip install -r requirements.txt

Note that the middle 'activate' command creates a special working environment, which must remain active for the 'pip install' and the 'python install.py' below!

# reenter virtualenv if needed:
. ./venv-pdnscontrol/bin/activate
cp instance/pdnscontrol.conf.example instance/pdnscontrol.conf
editor instance/pdnscontrol.conf
python install.py

. ./venv-pdnscontrol/bin/activate
python debug.py

Don't forget to enable the webserver and API features on your PowerDNS installations (experimental-webserver, experimental-webserver-address, experimental-webserver-password, experimental-json-interface for Recursor, experimental-json-interface and webserver-address for Authoritative). The 'experimental-' prefix denotes that the API might still change, but if it does, pdnscontrol will change with it.

See the instructions in Dockerfile on how to get a minimal Docker container with PowerDNS Authoritative Server and pdnscontrol.

To update built templates, you also need to have other software installed. See pdnscontrol/README.md for details.

If you update your checkout you might, but should not, have to run:

./manage.py assets build

Feeds PowerDNS stats into your Graphite installation.

Lives in pdns2graphite. Look at pdns2graphite/README.markdown for documentation.

Runs system-wide commands that affect the pdns binaries/processes. Also proxies the PowerDNS JSON interface for consumption over SSL.

Lives in pdnsmgrd. Look at pdnsmgrd/README.markdown for documentation.

The current code is known to run on these platforms:

• CentOS 6 (Python 2.7)
• Debian wheezy (Python 2.7)