PowerDNS manual
PowerDNS BV
pdns@powerdns.com
It is a book about a Spanish guy called Manual. You should read it.
-- Dilbert
Table of Contents
1.
The PowerDNS dynamic nameserver
1.1.
Function & design of PDNS
1.2.
About this document
1.3.
Release notes
1.3.1.
2.0 Release Candidate 2
1.3.2.
2.0 Release Candidate 1
1.3.3.
1.99.12 Prerelease
1.3.4.
1.99.11 Prerelease
1.3.5.
1.99.10 Prerelease
1.3.6.
1.99.9 Early Access Prerelease
1.3.7.
1.99.8 Early Access Prerelease
1.3.8.
1.99.7 Early Access Prerelease
1.3.9.
1.99.6 Early Access Prerelease
1.3.10.
1.99.5 Early Access Prerelease
1.3.11.
1.99.4 Early Access Prerelease
1.3.12.
1.99.3 Early Access Prerelease
1.3.13.
1.99.2 Early Access Prerelease
1.3.14.
1.99.1 Early Access Prerelease
1.4.
Acknowledgements
2.
Installing on Unix
2.1.
Possible problems at this point
2.2.
Testing your install
2.2.1.
Typical errors
2.3.
Running PDNS on unix
3.
Installing on Microsoft Windows
3.1.
Configuring PDNS on Microsoft Windows
3.2.
Running PDNS on Microsoft Windows
4.
Configure database connectivity
4.1.
Configuring MySQL
4.1.1.
Common problems
5.
Dynamic resolution using the PipeBackend
5.1.
Deploying the PipeBackend with the BindBackend
6.
Logging & Monitoring PDNS performance
6.1.
Webserver
6.2.
Via init.d commands
6.3.
Operational logging using syslog
7.
Security settings & considerations
7.1.
Settings
7.1.1.
Running as a less privileged identity
7.1.2.
Jailing the process in a chroot
7.2.
Considerations
8.
Virtual hosting
9.
Performance related settings
9.1.
PacketCache
10.
Migrating to PDNS
10.1.
Zone2sql
11.
Recursion
11.1.
Details
12.
Master/Slave operation & replication
12.1.
Native replication
12.2.
Slave operation
12.2.1.
Supermaster automatic provisioning of slaves
12.3.
Master operation
13.
Fancy records for seamless email and URL integration
14.
Index of all settings
15.
Index of all internal metrics
15.1.
Counters & variables
15.1.1.
Ring buffers
16.
Supported record types and their storage
A.
Backends in detail
A.1.
PipeBackend protocol
A.1.1.
Handshake
A.1.2.
Questions
A.1.3.
Answers
A.1.4.
Sample perl backend
A.2.
MySQL backend
A.2.1.
Configuration settings
A.2.2.
Notes
A.3.
MySQL PDNS backend
A.3.1.
Notes
A.4.
Generic MySQL backend
A.5.
Generic PgSQL backend
A.5.1.
Basic functionality
A.5.2.
Fancy records
A.5.3.
Settings and specifying queries
A.5.4.
Native operation
A.5.5.
Slave operation
A.5.6.
Superslave operation
A.5.7.
Master operation
A.6.
Generic Oracle backend
A.7.
DB2 backend
A.8.
Bind zone file backend
A.8.1.
Operation
A.8.2.
Performance
A.8.3.
Master/slave configuration
A.9.
ODBC backend
B.
PDNS internals
B.1.
Controlsocket
B.1.1.
pdns_control
B.2.
Guardian
B.3.
Modules & Backends
B.4.
How PDNS translates DNS queries into backend queries
C.
Backend writers' guide
C.1.
Simple read-only native backends
C.1.1.
A sample minimal backend
C.1.2.
Interface definition
C.2.
Reporting errors
C.3.
Declaring and reading configuration details
C.4.
Read/write slave-capable backends
C.4.1.
Supermaster/Superslave capability
C.5.
Read/write master-capable backends
C.6.
HOWTO & Frequently Asked Questions
List of Tables
16-1.
SOA fields
A-1.
MySQL backend capabilities
A-2.
MySQL backend capabilities
A-3.
Generic PgSQL backend capabilities
A-4.
DB2 backend capabilities
A-5.
Bind zone file backend capabilities
A-6.
ODBC backend capabilities
C-1.
DNSResourceRecord class
C-2.
SOAData struct
C-3.
DomainInfo struct
Next
The PowerDNS dynamic nameserver