Jan Dittberner
337947f50c
This commit adds documentation how to setup PowerDNS to use the gnuviechadmin DNS schema. The queries are provided in a PowerDNS configuration file. Addresses #17
59 lines
1.9 KiB
ReStructuredText
59 lines
1.9 KiB
ReStructuredText
Installation
|
|
============
|
|
|
|
You have several options in setting up your working environment. We recommend
|
|
using virtualenv to separate the dependencies of your project from your
|
|
system's python environment. If on Linux or Mac OS X, you can also use
|
|
virtualenvwrapper to help manage multiple virtualenvs across different
|
|
projects.
|
|
|
|
Virtualenv Only
|
|
---------------
|
|
|
|
First, make sure you are using virtualenv (http://www.virtualenv.org). Once
|
|
that's installed, create your virtualenv::
|
|
|
|
$ virtualenv --distribute gnuviechadmin
|
|
|
|
You will also need to ensure that the virtualenv has the project directory
|
|
added to the path. Adding the project directory will allow `django-admin.py` to
|
|
be able to change settings using the `--settings` flag.
|
|
|
|
Virtualenv with virtualenvwrapper
|
|
------------------------------------
|
|
|
|
In Linux and Mac OSX, you can install virtualenvwrapper
|
|
(http://virtualenvwrapper.readthedocs.org/en/latest/), which will take care of
|
|
managing your virtual environments and adding the project path to the
|
|
`site-directory` for you::
|
|
|
|
$ mkdir gnuviechadmin
|
|
$ mkvirtualenv -a gnuviechadmin gnuviechadmin-dev
|
|
$ cd gnuviechadmin && add2virtualenv `pwd`
|
|
|
|
Installation of Dependencies
|
|
=============================
|
|
|
|
Depending on where you are installing dependencies:
|
|
|
|
In development::
|
|
|
|
$ pip install -r requirements/local.txt
|
|
|
|
For production::
|
|
|
|
$ pip install -r requirements.txt
|
|
|
|
PowerDNS setup
|
|
==============
|
|
|
|
The models in :py:mod:`domains.models` are meant to be used together with a
|
|
PowerDNS setup with the generic PostgreSQL backend
|
|
(https://doc.powerdns.com/md/authoritative/backend-generic-mypgsql/). The
|
|
database schema differs a bit from the original schema to fit the Django model
|
|
conventions. To make PowerDNS work you have to redefine the SQL statements by
|
|
copying the following content to
|
|
:file:`/etc/powerdns/pdns.d/pdns.local.gva_queries.conf`.
|
|
|
|
.. literalinclude:: pdns.local.gva_queries.conf
|
|
:language: properties
|