documentation and consistency fixes

This commit is contained in:
Ben Charlton 2019-04-14 16:43:10 +01:00
parent 5858499113
commit 286e4d593a
3 changed files with 39 additions and 3 deletions

36
README.md Normal file
View file

@ -0,0 +1,36 @@
Symbiosis-dns-mythic
====================
Makes symbiosis compatible with Mythic Beasts DNS API.
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.
Usage
-----
You'll need to configure a password for your domain 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
good one.
6. Go to 'Manage DNS' for your domain, and make sure the template is set to
'None'.
7. You'll need to do this for each domain you intend to manage with symbiosis.
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.
Again, as root, run 'symbiosis-dns-mythic -v -f' to force an upload to the DNS
API in verbose mode.
These operations will be run automatically from cron in future, but it's good
to ensure that it works.

View file

@ -25,8 +25,8 @@
# DETAILS
#
# This script is designed to iterate over the domains hosted upon a Symbiosis
# system, and create TinyDNS snippets for each one. This can then be uploaded
# to the Bytemark content DNS service.
# system, and create DNS snippets for each one. This can then be published
# using the Mythic Beasts DNS API.
#
# Domains can also be specified manually on the command line, in which case
# only those domains will be processed.
@ -227,7 +227,7 @@ end
begin
if upload
upload_script = "/usr/sbin/symbiosis-mythic-dns"
upload_script = "/usr/sbin/symbiosis-dns-mythic"
verbose "Uploading using #{upload_script}"