blob: f1bda8065da6980eb64dc23fe0c9418ddf0d211e [file] [log] [blame]
Ivan Udovichenkoe25bced2018-08-07 12:52:46 +03001=====
2Usage
3=====
Ales Komarekd5029c82015-01-07 13:58:23 +01004
Ivan Udovichenkoe25bced2018-08-07 12:52:46 +03005PowerDNS, founded in the late 1990s, is a premier supplier
6of open source DNS software, services and support. Deployed
7throughout the world with some of the most demanding users
8of DNS, we pride ourselves on providing quality software
9and the very best support available.
Ales Komarekd5029c82015-01-07 13:58:23 +010010
Ivan Udovichenkoe25bced2018-08-07 12:52:46 +030011Sample Pillars
12==============
Ales Komarekd5029c82015-01-07 13:58:23 +010013
Ales Komarek347430d2015-01-07 17:41:49 +010014PowerDNS server with MySQL backend
Ales Komarekd5029c82015-01-07 13:58:23 +010015
Ivan Suzdal67bcad52017-05-26 18:45:54 +030016.. code-block:: yaml
Ivan Suzdal52f89302017-06-14 20:24:25 +030017
Ivan Udovichenkoe25bced2018-08-07 12:52:46 +030018 powerdns:
19 server:
20 api:
21 enabled: True
22 key: VxK9cMlFL5Ae
23 axfr_ips:
24 - 172.16.10.103
25 - 172.16.10.104
26 - 172.16.10.102
27 - 127.0.0.1
28 backend:
29 engine : mysql
30 host : localhost
31 port : 3306
32 dbname : powerdns
33 user : powerdns
34 password : powerdns
35 timeout': 10
36 dnssec : on
37 bind:
38 address: 172.16.10.103
39 overwrite_supermasters: True
40 supermasters:
41 - account: master
42 ip: 172.16.10.103
43 nameserver: ns1.example.org
44 - account: master
45 ip: 172.16.10.104
46 nameserver: ns2.example.org
47 - account: master
48 ip: 172.16.10.102
49 nameserver: ns3.example.org
50 webserver:
51 address: 172.16.10.103
52 enabled: True
53 password: gJ6n3gVaYP8eS
54 port: 8081
Ivan Suzdal67bcad52017-05-26 18:45:54 +030055
Ivan Udovichenkoe25bced2018-08-07 12:52:46 +030056.. note:: If you use one MySQL database across several
57 PowerDNS instances, be sure to pass *-b1* parameter
58 to *salt* command to avoid race condition.
59
60PowerDNS server with SQLite backend
Ivan Suzdal67bcad52017-05-26 18:45:54 +030061
62.. code-block:: yaml
Ivan Udovichenkoe25bced2018-08-07 12:52:46 +030063
64 powerdns:
65 server:
66 api:
67 enabled: True
68 key: VxK9cMlFL5Ae
69 axfr_ips:
70 - 172.16.10.103
71 - 172.16.10.104
72 - 172.16.10.102
73 - 127.0.0.1
74 backend:
75 engine: sqlite
76 dbname: pdns.sqlite
77 dbpath: /var/lib/powerdns
78 bind:
79 address: 172.16.10.103
80 overwrite_supermasters: True
81 supermasters:
82 - account: master
83 ip: 172.16.10.103
84 nameserver: ns1.example.org
85 - account: master
86 ip: 172.16.10.104
87 nameserver: ns2.example.org
88 - account: master
89 ip: 172.16.10.102
90 nameserver: ns3.example.org
91 webserver:
92 address: 172.16.10.103
93 enabled: True
94 password: gJ6n3gVaYP8eS
95 port: 8081
Ivan Suzdal67bcad52017-05-26 18:45:54 +030096
Ales Komarekd5029c82015-01-07 13:58:23 +010097
Ivan Udovichenkoe25bced2018-08-07 12:52:46 +030098Documentation
99=============
100
101* https://doc.powerdns.com/