System Services: DNS Server
===========================

**System Services> DNS Server**

This menu section in NodeWorx is where Server Administrators can manage their DNS settings and records/zones, 
as well as manage DNS synchronization.

InterWorx uses djbdns for its DNS services. BIND is not supported at this time. 

Detailed documentation on managing DNS services can be found :doc:`here </nodeworx/dns/index>`.

.. contents::

Overview
--------

**System Services > DNS Server > Overview**

.. image:: /images/nw101-dns-overview.png
   :alt: dns overview page
   :class: float-right

From the DNS Overview page, Server Administrators can easily manage: 

- Default nameservers
- Active IPs for DNS services
- DNS service status for IPs active on the server
- DNS zone defaults
- SOA serial format

Documentation on managing DNS settings can be found :doc:`here </nodeworx/dns/dns-server-guide>`.

.. rst-class::  clear-both

Zones
-----

**System Services > DNS Server > Zones**

.. image:: /images/nw101-zones.png
   :alt: dns zones page
   :class: float-right

When a SiteWorx account is created, a DNS template is created for each primary and secondary domain
associated with the account. DNS records are stored in the database and then exported 
to ``/var/djbdns/tinydns/root/data.cdb``. This is a binary file that cannot be modified, directly.

From the DNS Zones page, Server Administrators can easily: 

- Manage the default DNS template
- Manage DNS zones for individual primary and secondary domains
  
Documentation on types of DNS Records can be found :doc:`here </nodeworx/dns/types-of-dns-records>`.

Documentation on editing and adding DNS Records can be found :doc:`here </nodeworx/dns/manage-dns-zones-and-records>`.

.. rst-class::  clear-both

Synchronization
---------------

**System Services > DNS Server > Synchronization**

.. image:: /images/nw101-dns-sync.png
   :alt: dns sync page
   :class: float-right

InterWorx allows the ability to use external InterWorx servers for DNS, as well as synchronize 
two or more InterWorx servers’ DNS functionality. This creates a redundancy, so that, if one 
DNS service goes down, there will be a redundant service in place.

For DNS Synchronization, servers are defined in two ways:

- The Listening Server: The external InterWorx server where DNS zones will be published to
- The Publishing Server: The local InterWorx server where DNS zones will be published from

Synchronized DNS entries are not visible via the InterWorx interface. They can be tested at the CLI 
using dig. Example:

.. code-block:: 

   dig domain.com @ns1.liseningserver.com

From the DNS Synchronization page, Server Administrators can easily add and remove external InterWorx 
DNS servers.

Documentation related to DNS Synchronization can be found :doc:`here </nodeworx/dns/setup-dns-synchronization-nodeworx>`.