diff options
author | Kiall Mac Innes <kiall@hp.com> | 2013-09-16 10:44:20 +0100 |
---|---|---|
committer | Kiall Mac Innes <kiall@hp.com> | 2013-09-16 10:53:39 +0100 |
commit | 848d5aa613602c9b8eff1491721f6ba24a908e4e (patch) | |
tree | 607de6fe455abe99931e9cacd30bcf960df1babd | |
parent | fde4d7e01b150655434c0969ad94c16e3db2fa7d (diff) | |
download | designate-848d5aa613602c9b8eff1491721f6ba24a908e4e.tar.gz |
Add initial BIND9 backend docs
Change-Id: I28afe376026c6546a1e87bad5bdf67ae6b4d907e
-rw-r--r-- | doc/source/backends.rst | 25 | ||||
-rw-r--r-- | doc/source/backends/bind9.rst | 51 | ||||
-rw-r--r-- | doc/source/index.rst | 1 |
3 files changed, 77 insertions, 0 deletions
diff --git a/doc/source/backends.rst b/doc/source/backends.rst new file mode 100644 index 00000000..cf286a1e --- /dev/null +++ b/doc/source/backends.rst @@ -0,0 +1,25 @@ +.. + 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. + +Backend Documenation +==================== + +Contents: + +.. toctree:: + :maxdepth: 2 + :glob: + + backends/bind9 diff --git a/doc/source/backends/bind9.rst b/doc/source/backends/bind9.rst new file mode 100644 index 00000000..31f1904a --- /dev/null +++ b/doc/source/backends/bind9.rst @@ -0,0 +1,51 @@ +.. + 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. + +BIND9 Backend +============= + +.. note:: + The BIND9 backend, while functional, is lacking a solid process for + distributing zonefiles among multiple DNS servers. The soon to be introduced + concept of "Pools" will provide a foundation to fix this. + +Designate Configuration +----------------------- + +Configuration Options required for BIND9 operation:: + + [service:central] + state-path = /var/lib/designate + backend_driver = bind9 + + [backend:bind9] + rndc-host = 127.0.0.1 + rndc-port = 953 + rndc-config-file = /etc/bind9/rndc.conf # If required by BIND9 + rndc-key-file = /etc/bind/rndc.key + +BIND9 Configuration +------------------- + +Include the Designate generated configuration in /etc/bind/named.conf.local:: + + include "/var/lib/designate/bind9/zones.config"; + +Ensure BIND9 can access the above config, one way to achieve this is by +disabling AppArmour:: + + $ touch /etc/apparmor.d/disable/usr.sbin.named + $ service apparmor reload + $ service bind9 restart diff --git a/doc/source/index.rst b/doc/source/index.rst index 6cbbf948..5ecf2ec0 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -31,6 +31,7 @@ also be found on the `OpenStack wiki`_. related production-architecture glossary + backends Indices and tables |