README (1765B)
1 # Ascension 2 3 Tool to easily migrate existing DNS Zones into the GNU Name System using 4 incremental zone transfers (AXFR/IXFR). 5 6 ## How to install 7 To install the ascension simply execute one of the following commands in the 8 freshly cloned directory: 9 10 ```bash 11 # System wide installation 12 sudo python3 setup.py install 13 14 # Local installation through virtualenv 15 python3 -m venv .venv 16 source .venv/bin/activate 17 python3 setup.py install 18 ``` 19 20 ## How to install (Developer) 21 A developer installation is very handy when you are making changes to the source 22 code as this way you don't need to re-run the installation procedure every time 23 you make a change. 24 25 ```bash 26 # installation through virtualenv 27 python3 -m venv .venv 28 source .venv/bin/activate 29 python3 setup.py develop 30 ``` 31 32 ## How to use 33 If you have installed it, simply execute ascension with one of several options. 34 You can also just run the file ascension.py itself directly. 35 36 Taken from the docstring of the ascension.py file: 37 ``` 38 Ascension 39 40 Usage: 41 ascension <domain> [-d] [-p] 42 ascension <domain> <port> [-d] [-p] 43 ascension <domain> -n <transferns> [-d] [-p] 44 ascension <domain> -n <transferns> <port> [-d] [-p] 45 ascension -p | --public 46 ascension -h | --help 47 ascension -v | --version 48 49 Options: 50 <domain> Domain to migrate 51 <port> Port for zone transfer 52 <transferns> DNS Server that does the zone transfer 53 -p --public Make records public on the DHT 54 -d --debug Enable debugging 55 -h --help Show this screen. 56 -v --version Show version. 57 ``` 58 59 Example use: 60 ``` 61 # Transfers the sy TLD from ns1.tld.sy. 62 ascension sy -n ns1.tld.sy. 63 # Transfers the nu TLD from zonedata.iis.se with debug options enabled 64 ascension nu -n zonedata.iis.se. -d 65 ```