bcc/symbiosis-dns-mythic
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve readme

Browse source
This commit is contained in:
Ben Charlton 2019-04-14 17:08:40 +01:00
parent 286e4d593a
commit 9c25aa142d
1 changed files with 26 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

33
README.md
View file

@ -7,30 +7,49 @@ There are a few differences from the original, notably that the old
/root/BytemarkDNS directory and upload script is no longer used, with the
uploads now being performed by symbiosis-dns-mythic.
Installation
------------
It's best to 'dpkg --purge symbiosis-dns' before installing
symbiosis-dns-mythic, but at the very least you will have to remove it first
if installed.
Usage
-----
You'll need to configure a password for your domain on the Mythic Beasts
You'll need to configure passwords for your domains on the Mythic Beasts
control panel.
1. Log in to https://ctrlpanel.mythic-beasts.com
2. Click 'my domains'
3. Click on the domain you wish to use.
4. Under 'Nameservers and DNS' click on 'DNS API'.
5. Set a random password. You'll only need to remember this once, so make it a
5. Set a random password. You'll only need to use this once, so make it a
good one.
6. Go to 'Manage DNS' for your domain, and make sure the template is set to
'None'.
'None', or you'll get errors when creating NS records.
7. You'll need to do this for each domain you intend to manage with symbiosis.
It's best to use a unique password for each domain. The pwgen command is
excellent for generating them - 'apt-get install pwgen' if it is missing.
Once you've installed the symbiosis-dns-mythic package on your server, you'll
need to give Symbiosis your DNS password. To do this, put it in a file called
'mbpassword' in the /srv/my-brilliant-site.com/config/dns/ directory.
As root, run 'symbiosis-dns-generate --verbose --force' to regenerate the DNS
records.
records. These will be under
/srv/my-brilliant-site.com/config/dns/my-brillant-site.com.txt as usual, but
no longer in TinyDNS format.
Again, as root, run 'symbiosis-dns-mythic -v -f' to force an upload to the DNS
API in verbose mode.
API in verbose mode. This will tell you if you have any template or auth
problems.
These operations will be run automatically from cron in future, but it's good
to ensure that it works.
These operations will be run automatically from cron in future, after any
changes.
TODO
----
* Support automatic DNS for subdomains, which symbiosis can't currently do.
* Make --verbose work automatically for uploads too.
* Detect presence of NS records and skip them if the Mythic DNS template is not 'none'
* Make failures a bit more transparent.
* Clean up some of the spurious template warnings.