PowerDNS manual

pdns@powerdns.com

How to install, launch and operate the PowerDNS nameserver

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. 1.99.9 Early Access Prerelease
1.3.2. 1.99.8 Early Access Prerelease
1.3.3. 1.99.7 Early Access Prerelease
1.3.4. 1.99.6 Early Access Prerelease
1.3.5. 1.99.5 Early Access Prerelease
1.3.6. 1.99.4 Early Access Prerelease
1.3.7. 1.99.3 Early Access Prerelease
1.3.8. 1.99.2 Early Access Prerelease
1.3.9. 1.99.1 Early Access Prerelease

1.4. Acknowledgements

2. Installing

2.1. Possible problems at this point

2.2. Testing your install

2.2.1. Typical errors

3. Running PDNS

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. Monitoring PDNS performance

6.1. Webserver
6.2. Via init.d commands

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. Slave operation

12.1. Details
12.2. Supermaster automatic provisioning of slaves

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. Generic MySQL backend

A.4. Generic PgSQL backend

A.4.1. Settings

A.5. Generic Oracle backend

A.6. Bind zone file backend

A.6.1. Operation
A.6.2. Performance
A.6.3. Master/slave configuration

B. PDNS internals

B.1. Controlsocket
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 non-slave backends

C.1.1. A sample minimal backend
C.1.2. Interface definition
C.1.3. Reporting errors
C.1.4. Declaring and reading configuration details

C.2. Read/write slave-capable backends

List of Tables
16-1. SOA fields
C-1. DNSResourceRecord class
C-2. SOAData struct

		Next
		The PowerDNS dynamic nameserver