From e3f6a5c29d2ea1cef92e10f142b7883ee6347ca7 Mon Sep 17 00:00:00 2001 From: rexxnor Date: Wed, 30 Jan 2019 18:49:50 +0100 Subject: updated ascension documentation --- doc/handbook/chapters/installation.texi | 24 +++++++++++++++++------- 1 file changed, 17 insertions(+), 7 deletions(-) (limited to 'doc/handbook/chapters/installation.texi') diff --git a/doc/handbook/chapters/installation.texi b/doc/handbook/chapters/installation.texi index bdff20802..fc580bdb7 100644 --- a/doc/handbook/chapters/installation.texi +++ b/doc/handbook/chapters/installation.texi @@ -1697,31 +1697,41 @@ configured proxy) should give you a valid SSL certificate for @node Migrating existing DNS zones into GNS @subsubsection Migrating existing DNS zones into GNS -To migrate an existing zone into GNS use the ascension tool. +To migrate an existing zone into GNS use the Ascension tool. Ascension transfers entire zones into GNS by doing incremental zone transfers and then adding the records to GNS. +Compared to the gnunet-zoneimport tool it strictly uses AXFR or IXFR depending +on whether or not there exists a SOA record for the zone. If that is the case it +will take the serial as a reference point and request the zone. The server will +either answer the IXFR request with a correct incremental zone or with the +entire zone, which depends on the server configuration. + You can find the source code here: @code{https://gnunet.org/git/ascension.git/} -The software can be installed into a python virtual environment like this: +The software can be installed into a Python virtual environment like this: @example $ python3 -m venv .venv $ source .venv/bin/activate $ python3 setup.py install @end example -Or installed globally like this (not recommended): +Or installed globally like this: @example $ sudo python3 setup.py install @end example -The advantage of using a virtual environment is, that all the dependencies can -be installed separately in different versions without touching your existing -python installation and its dependencies. +Pip will then install all the necessary requirements that are needed to run +Ascension. For development purposes a virtual environment should suffice. +Keeping a virtual environment helps with keeping things tidy and prevents +breaking of Ascension through a future Python update. -Using the tool is discussed in the user section of the documentation. +The advantage of using a virtual environment is, that all the dependencies can +be installed separately in different versions without touching your system +Python installation and its dependencies. +@xref{Migrating an existing DNS zone into GNS} for usage manual of the tool. @node Configuring the GNUnet VPN @subsection Configuring the GNUnet VPN -- cgit v1.2.3