How to: Manage DNS Zones and Records
====================================

From the DNS Zones page in NodeWorx, server administrators can add and edit DNS zones and records 
for the domains on the server. 

Descriptions of the different types of DNS zones and their add and edit requirements can be 
found :doc:`here </nodeworx/dns/types-of-dns-records>`.

.. note::

   By default, this page is the only location where domain A records can be managed. A record editing can 
   be enabled for Siteworx accounts in ``~iworx/iworx.ini``. See `To Enable A Record Management For SiteWorx`_.

.. contents::

To View the DNS Records for a Domain 
------------------------------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **System Services > DNS Server > Zones**

   .. image:: /images/dns-zones.png
      :alt: DNS Zones

#. Click the **Magnifying Glass** next to the domain. This opens the specific DNS records page for that domain 

To Edit a DNS Records for a Domain 
----------------------------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **System Services > DNS Server > Zones**
#. Click the **Magnifying Glass** next to the domain. This opens the DNS Records page
  
   .. image:: /images/dns-records.png
      :alt: DNS Records
   
#. Click the **Pencil** next to the record to edit. This opens the Edit DNS Record Form 
#. Update the desired information
#. Click **Save**
 
To Add a DNS Record for a Domain
--------------------------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **System Services > DNS Server > Zones**
#. Click the **Magnifying Glass** next to the domain. This opens the DNS Records page
#. From the Add a New dropdown, select the **type of record** 
   
   .. image:: /images/nw-dns-record-list.png
      :alt: dns record type list 

#. Click **Go**. This opens the Add DNS Record form. This form is a different for each type 
   of record, as they all require different configuration information. Details can be found 
   :doc:`here </nodeworx/dns/types-of-dns-records>`
#. Update the required information 
#. Click **Save**

To Enable A Record Management For SiteWorx
------------------------------------------

.. warning::


   This setting should be enabled with extreme caution, as it allows the potential for SiteWorx users to 
   accidentally delete records that are required for their domains to be accessible from the browser. 

.. note:: 

   This is a global setting. It is not possible to enable access to edit A records per-account.

#. Log in to the server at the CLI as root, either via SSH or from the terminal
#. At the CLI, run the following. This will enable the SiteWorx A Record Control setting in ``~iworx/iworx.ini``:

   .. code-block::

      ~iworx/bin/ini.pex --set --section dns --index siteworx_a_record_control --value 1

To Disable A Record Management For SiteWorx
-------------------------------------------

.. note:: 

   This is a global setting. It is not possible to disable access to edit A records per-account.

#. Log in to the server at the CLI as root, either via SSH or from the terminal
#. At the CLI, run the following. This will disable the SiteWorx A Record Control setting in ``~iworx/iworx.ini``:

   .. code-block::

      ~iworx/bin/ini.pex --set --section dns --index siteworx_a_record_control --value 0