diff options
author | Endre Karlson <endre.karlson@hp.com> | 2014-03-18 16:21:55 +0100 |
---|---|---|
committer | Endre Karlson <endre.karlson@hp.com> | 2014-03-18 23:03:11 +0100 |
commit | 3be64a72047b15ba6eb4a9a6a2f5ec84b278cc98 (patch) | |
tree | c5496e744c9928005828f1c57ba2e38bd49e548f | |
parent | 1fe5823510d7416d09c8af41582e394678cee12d (diff) | |
download | designate-3be64a72047b15ba6eb4a9a6a2f5ec84b278cc98.tar.gz |
Document the PowerDNS backend
Change-Id: Ia94690ec6f990c0723333c4e872d5dec3ee626ef
-rw-r--r-- | doc/source/backends.rst | 1 | ||||
-rw-r--r-- | doc/source/backends/powerdns.rst | 89 |
2 files changed, 90 insertions, 0 deletions
diff --git a/doc/source/backends.rst b/doc/source/backends.rst index 7ff34409..a4e8d5da 100644 --- a/doc/source/backends.rst +++ b/doc/source/backends.rst @@ -23,3 +23,4 @@ Contents: :glob: backends/bind9 + backends/powerdns diff --git a/doc/source/backends/powerdns.rst b/doc/source/backends/powerdns.rst new file mode 100644 index 00000000..395c6868 --- /dev/null +++ b/doc/source/backends/powerdns.rst @@ -0,0 +1,89 @@ +.. + Copyright 2013 Hewlett-Packard Development Company, L.P. + + Licensed under the Apache License, Version 2.0 (the "License"); you may + not use this file except in compliance with the License. You may obtain + a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, WITHOUT + WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the + License for the specific language governing permissions and limitations + under the License. + + +PowerDNS Backend +================ + +Designate Configuration +----------------------- + +=============================== ====================================== ============================================================== +Parameter Default Note +=============================== ====================================== ============================================================== +domain_type NATIVE PowerDNS Domain Type +also_notify [] List of additional IPs to send NOTIFYs to. +database_connection sqlite:///$pystatepath/powerdns.sqlite Database connection string +connection_debug 0 Verbosity of SQL debugging information. 0=None, 100=Everything +connection_trace False Add python stack traces to SQL as comment strings +idle_timeout 3600 timeout before idle sql connections are reaped +max_retries 10 maximum db connection retries during startup. + (setting -1 implies an infinite retry count) +retry_interval 10 interval between retries of opening a sql connection +mysql_engine InnoDB MySQL engine to use +sqlite_synchronous True If passed, use synchronous mode for sqlite +=============================== ====================================== ============================================================== + + +PowerDNS Configuration +------------------- + +You need to configure PowerDNS to use the MySQL backend. + +1. First enable the MySQL backend: + + launch = gmysql + +2. Configure the MySQL database settings:: + + gmysql-host=<host> + gmysql-port= + gmysql-dbname=<dbname> + gmysql-user=<username> + gmysql-password=<password> + gmysql-dnssec=yes + #gmysql-socket=<socket path> + +.. note:: + PowerDNS can connect via socket or host/port. + +3. Configure the options for designate-central - specifaclly "database_connection" to point to your MySQL database:: + + [backend:powerdns] + database_connection = mysql://<username>:<password>@<host>:<port>/<dbname> + +4. Setup the database schema. + +:: + + $ designate-manage powerdns database-init + $ designate-manage powerdns database-sync + +5. Restart PowerDNS and it should be ready to serve queries using the MySQL database as the backing store. + + +PowerDNS deployment as hidden Master +------------------------------------ + +One deployment scenario can be that the PowerDNS backend will be used as a "hidden" Master DNS for other DNS servers to consume via AXFR. + +Say you have 10.0.0.1 and 10.0.0.2 as slaves then configure the backend as follows in addition to other options:: + + [backend:powernds] + domain_type = MASTER + also_notify = 10.0.0.1,10.0.0.2 + +.. note:: + This should mostly be used in connection with another backend acting as slave.
\ No newline at end of file |