diff options
author | rexxnor <rexxnor+gnunet@brief.li> | 2019-01-30 18:49:50 +0100 |
---|---|---|
committer | rexxnor <rexxnor+gnunet@brief.li> | 2019-01-30 18:53:05 +0100 |
commit | e3f6a5c29d2ea1cef92e10f142b7883ee6347ca7 (patch) | |
tree | fc00cb008568945fd947dc86f24efde7b35aed63 /doc/handbook/chapters/installation.texi | |
parent | 404c9065789248a5eba44fb4bc320bfeaa988da6 (diff) | |
download | gnunet-e3f6a5c29d2ea1cef92e10f142b7883ee6347ca7.tar.gz gnunet-e3f6a5c29d2ea1cef92e10f142b7883ee6347ca7.zip |
updated ascension documentation
Diffstat (limited to 'doc/handbook/chapters/installation.texi')
-rw-r--r-- | doc/handbook/chapters/installation.texi | 24 |
1 files changed, 17 insertions, 7 deletions
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 | |||
1697 | @node Migrating existing DNS zones into GNS | 1697 | @node Migrating existing DNS zones into GNS |
1698 | @subsubsection Migrating existing DNS zones into GNS | 1698 | @subsubsection Migrating existing DNS zones into GNS |
1699 | 1699 | ||
1700 | To migrate an existing zone into GNS use the ascension tool. | 1700 | To migrate an existing zone into GNS use the Ascension tool. |
1701 | 1701 | ||
1702 | Ascension transfers entire zones into GNS by doing incremental zone transfers | 1702 | Ascension transfers entire zones into GNS by doing incremental zone transfers |
1703 | and then adding the records to GNS. | 1703 | and then adding the records to GNS. |
1704 | 1704 | ||
1705 | Compared to the gnunet-zoneimport tool it strictly uses AXFR or IXFR depending | ||
1706 | on whether or not there exists a SOA record for the zone. If that is the case it | ||
1707 | will take the serial as a reference point and request the zone. The server will | ||
1708 | either answer the IXFR request with a correct incremental zone or with the | ||
1709 | entire zone, which depends on the server configuration. | ||
1710 | |||
1705 | You can find the source code here: @code{https://gnunet.org/git/ascension.git/} | 1711 | You can find the source code here: @code{https://gnunet.org/git/ascension.git/} |
1706 | 1712 | ||
1707 | The software can be installed into a python virtual environment like this: | 1713 | The software can be installed into a Python virtual environment like this: |
1708 | @example | 1714 | @example |
1709 | $ python3 -m venv .venv | 1715 | $ python3 -m venv .venv |
1710 | $ source .venv/bin/activate | 1716 | $ source .venv/bin/activate |
1711 | $ python3 setup.py install | 1717 | $ python3 setup.py install |
1712 | @end example | 1718 | @end example |
1713 | 1719 | ||
1714 | Or installed globally like this (not recommended): | 1720 | Or installed globally like this: |
1715 | @example | 1721 | @example |
1716 | $ sudo python3 setup.py install | 1722 | $ sudo python3 setup.py install |
1717 | @end example | 1723 | @end example |
1718 | 1724 | ||
1719 | The advantage of using a virtual environment is, that all the dependencies can | 1725 | Pip will then install all the necessary requirements that are needed to run |
1720 | be installed separately in different versions without touching your existing | 1726 | Ascension. For development purposes a virtual environment should suffice. |
1721 | python installation and its dependencies. | 1727 | Keeping a virtual environment helps with keeping things tidy and prevents |
1728 | breaking of Ascension through a future Python update. | ||
1722 | 1729 | ||
1723 | Using the tool is discussed in the user section of the documentation. | 1730 | The advantage of using a virtual environment is, that all the dependencies can |
1731 | be installed separately in different versions without touching your system | ||
1732 | Python installation and its dependencies. | ||
1724 | 1733 | ||
1734 | @xref{Migrating an existing DNS zone into GNS} for usage manual of the tool. | ||
1725 | 1735 | ||
1726 | @node Configuring the GNUnet VPN | 1736 | @node Configuring the GNUnet VPN |
1727 | @subsection Configuring the GNUnet VPN | 1737 | @subsection Configuring the GNUnet VPN |