How to install Atomia DNS

The Atomia DNS Master server consists of two different parts, the Atomia DNS database and the Atomia DNS API. It is possible to install the Atomia DNS Master server either with the database and the API on the same machine or on different machines. The default and recommended way is to install both on the same machine. In addition, if you want to use DNSSEC, it consists of an optional step where you add the initial DNSSEC keyset.

Default installation

The default installation will install both the Atomia DNS database and the Atomia DNS API.

Software used in example:

  • Ubuntu LTS (instructions for alternative operating system can be found in the Atomia DNS manual)
  • Atomia DNS
  1. Do a standard installation of Ubuntu 12.04 or 14.04 LTS.

  2. Become root
  3. Add the Atomia APT Repository to the server using:

    repo="$(wget -q -O - http://public.apt.atomia.com/setup.sh.shtml | sed s/%distcode/`lsb_release -c | awk '{ print $2 }'`/g)"; echo "$repo"

    Verify that you are OK with executing our APT repository install script, and then:

    echo "$repo" | sh
  4. Install the Atomia DNS Master:

    apt-get install atomiadns-masterserver
  5. Add the initial DNSSEC keyset (optional):

    See Creating the initial DNSSEC keyset for instructions.

Before using the Atomia DNS client

If you would like to use the atomiadnsclient command line tool you will need to add the following parameters in /etc/atomiadns.conf:

soap_uri = http://localhost/atomiadns
soap_username = same as auth_admin_username
soap_password = same as auth_admin_password

How to install the Atomia DNS web app (optional)

In this example we will install the Atomia DNS web app on the same machine as the Atomia DNS Master server.

Keep in mind that the web app is in a very early stage of development.

  1. Use apt-get to run the installation:

    apt-get install atomiadns-webapp
  2. If you haven’t yet installed your first nameserver by following the guide at Install and configure a name server (PowerDNS), then you need to create your nameserver group for the webapp to work. You can do this by executing the following command:

    atomiadnsclient --method AddNameserverGroup --arg default

  3. You will also have enable authin atomiadns.conf and create an admin user:

    require_auth = 1
    auth_admin_user = admin_user@name.com
    auth_admin_pass = admin_password
    

    The admin user name must be formatted as an email address.

  4. Restart Apache:

    apache2ctl graceful
  5. Start the web app by running the following command:

    start atomiadns-webapp
  6. Add your first user (CURL example). For X-Auth, use the admin username and password set in atomiadns.conf:

    curl -i -X POST -d '[ "new_user@name.com", "new_password" ]' -H 'X-Auth-Username: admin_username' -H 'X-Auth-Password: admin_password'  'http://localhost/pretty/atomiadns.json/AddAccount'
  7. Browse to the webb app in the browser and log in with the newly created credentials:

    http://localhost:5380

    The default port for the Atomia DNS control panel is 5380.

More information: