~seth-arnold/charms/precise/pdns-recursor/trunk

« back to all changes in this revision

Viewing changes to README

  • Committer: Seth Arnold
  • Date: 2013-03-28 06:56:54 UTC
  • Revision ID: seth.arnold@canonical.com-20130328065654-glz7wur6a1ofz6l7
Initial charm

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Overview
 
2
--------
 
3
 
 
4
This charm provides the PowerDNS recursor from the pdns-recursor package.
 
5
A DNS recursor will handle DNS requests completely, starting from the
 
6
root nameservers to find the .com, .org, .net, etc. nameservers, to
 
7
finally querying the authoritative nameservers for a zone.
 
8
 
 
9
This is especially useful for ISPs or organizations that want to reduce
 
10
DNS queries or provide a recursor that is extremely resilient to DNS
 
11
cache poisoning attacks commonly employed against DNS servers that mix
 
12
the authoritative and recursive functions into one process.
 
13
 
 
14
Usage
 
15
-----
 
16
 
 
17
To deploy, run
 
18
 
 
19
    juju set pdns-recursor allow-from=192.168.0.0/16
 
20
    juju set pdns-recursor local-address=192.168.0.2
 
21
    juju deploy pdns-recursor
 
22
 
 
23
This charm can set the `allow-from`, `local-address`, `local-port`
 
24
configuration options. 
 
25
 
 
26
Configuration
 
27
-------------
 
28
 
 
29
This charm only allows setting `allow-from`, `local-address`, and
 
30
`local-port`.
 
31
 
 
32
- `local-address` -- without a `local-address`, pdns-recursor will bind to
 
33
  127.0.0.1, somewhat limiting its utility.
 
34
 
 
35
- `local-port` -- without a `local-port`, will bind to port 53. This will
 
36
  rarely be used.
 
37
 
 
38
- `allow-from` -- without a `allow-from`,  pdns-recursor will allow
 
39
  localhost, RFC 1918 networks (and their IPv6 equivalents) to make
 
40
  queries. (127.0.0.0/8, 10.0.0.0/8, 192.168.0.0/16, 172.16.0.0/12,
 
41
  ::1/128, fe80::/10.)
 
42
 
 
43
Future versions are liable to expose the `auth-zones`, `forward-zones`,
 
44
and `forward-zones-file` configuration options.
 
45
 
 
46
Contact Information
 
47
-------------------
 
48
 
 
49
Author: Seth Arnold <seth.arnold@canonical.com>
 
50
Report bugs at: http://bugs.launchpad.net/charms
 
51
Location: http://jujucharms.com