Guide to DNS Cluster Configuration

AllDocumentation/WHMDocs
cPanel & WHM 11.38
Installation Guides
cPanel User Guide
WHM User Guide
Apache & WHM
Change Log
Software Development Kit
Additional Documentation
PCI Compliance
cPanel Game Server (cPGS)
All English Documentation
Español – Documentación completa
RSS Feed
Documentation Home>
AllDocumentation/WHMDocs>WHMHomeScreen>ClusterRemoteEditAttach
---+!! Guide to <nop>DNS Cluster Configuration
 *For WHM version 11.38*

(<em>Home >> Cluster/Remote Access >> Configure Cluster</em>)

%TOC%

---++ Introduction

A DNS cluster is a number of nameservers that share records.

Clustering allows you to physically separate your nameservers so that in the event of, for instance, a power outage, you still have <nop>DNS functionality. This way, visitors can reach websites on your server more quickly after the web server comes back online. (The cPanel <nop>DNS <nop>cluster feature only provides redundancy for <nop>DNS. It does not place Apache or any other services in a <nop>cluster configuration.)

To optimally configure your <nop>DNS <nop>cluster, you will need 2 spare servers, both preferably running cPanel <nop>DNSONLY. You will also need at least 1 web server with cPanel & WHM installed.
   * cPanel <nop>DNSONLY is software that allows you to run a dedicated physical nameserver. It should only be installed on nameservers with _no_ previous content on them.
   * You can download the [[http://httpupdate.cpanel.net/cpanel-dnsonly-install.sea][cPanel DNSONLY software]] for free.
   * All machines in the <nop>cluster must be running cPanel & WHM or cPanel <nop>DNSONLY version 11 or higher. (Some features may not work with older versions of cPanel & WHM.)
   * You may have multiple cPanel <nop>DNSONLY servers and multiple cPanel & WHM servers in a cluster.

---++ Enabling <nop>DNS clustering on each server

First, you will need to enable DNS clustering via each server's WHM interface:
   1 Navigate to WHM&rsquo;s _Configure Cluster_ screen.
   1 Select _Enable DNS Clustering._
   1 Click _Change_.
   1 Click _Return to Cluster Status_.

<p align="center"><img alt="Image of 'Enable DNS Clustering' box." src="%ATTACHURLPATH%/modifycluster1.png" width='368' height='134' /><br /><em>Selecting 'Enable DNS Clustering' to turn on clustering.</em></p>

DNS clustering is now enabled. Next, specify which server(s) you wish to cluster, or share DNS information with.

   * You will need to sync each web server to its DNS servers.
   * You do not need to link dedicated DNS servers to each other, or link dedicated web servers to each other.
   * You should not set a DNS server to sync data back to a web server, as this will put extraneous data on the web server.

---++ Global <nop>cluster options 

This section allows you to specify the number of =<nop>dnsadmin</nop>= commands that are allowed to fail before WHM disables a member of your cluster. Disabling unresponsive cluster members can improve server performance.

   1 Select an option:
      * _10_ is the default. We recommend this setting.
      * To enter a different failure threshold, select the second button and enter the number of failed commands you wish to allow. 
      * If you wish for all of the members of your cluster to remain online at all times, select _Keep all cluster members online at all times_.
   1 If you want WHM to notify you when it disables an unresponsive member, select _Get a notification when WHM disables an unresponsive cluster member._
      * WHM will send the notifications during DNS queue processing.
   1 Click _Change_.

<p align="center"><img alt="Image of Global Cluster Options box." src="%ATTACHURLPATH%/globalclusteroptions1.png" width='742' height='251' /><br /><em>Disabling unresponsive cluster members.</em></p>

---++ About your <nop>DNS <nop>cluster configuration

Before you set up your DNS cluster, consider how you will structure it.

---+++ Directly linking the web server to the nameservers

Creating a cluster setup with direct links between servers can decrease CPU load, improving the performance of your servers. The more steps, or "hops," between a web server and a nameserver, the slower the servers' performance will be.

If at all possible, you should link your web server directly to the DNS servers, as shown in the diagram below. This is the ideal DNS setup.

<p align="center"><img width="335" alt="A direct link is optimal." src="http://docs.cpanel.net/twiki/pub/AllDocumentation/WHMDocs/ConfigureCluster/directlink.jpg" height="233" /> <br /><em>Figure 1. A direct link between the web server and 2 nameservers is optimal.</em> </p>

In this example, =webserver.example.com= sends DNS information directly to =ns1.example.com= and =ns2.example.com=. You can create this setup by using the WHM _Configure Cluster_ feature to link the web server directly to each nameserver (see the instructions below).

---+++ Using the primary <nop>nameserver</nop> as an intermediary

If necessary, you may place the primary nameserver between the web server and the secondary nameserver. For each intermediate server that you add, the data transfer time will be 3 times slower than for a direct link.

<p align="center"><img width="404" alt="An intermediate nameserver is acceptable." src="http://docs.cpanel.net/twiki/pub/AllDocumentation/WHMDocs/ConfigureCluster/2hops.jpg" height="178" /> <br /><em>Figure 2. An intermediate nameserver between the web server and secondary nameserver is acceptable.</em> </p>

You can create this configuration by setting the web server to sync the primary nameserver, and setting the primary nameserver to sync the secondary nameserver (see the instructions below).

---+++ Using multiple intermediary nameservers

The least optimal configuration uses multiple &ldquo;hops,&rdquo; or steps, between the web server and nameservers. This increases processor load on the servers, as the nameserver software works to update the DNS information on each hop, slowing response time.

<p align="center"><img width="359" alt="Multiple hops slows performance." src="http://docs.cpanel.net/twiki/pub/AllDocumentation/WHMDocs/ConfigureCluster/multihops.jpg" height="241" /> <br /><em>Figure 3. Configuring multiple hops between a web server and nameserver slows performance.</em> </p>

In this example, for =web1.example.com= to communicate with =ns2.example.com=, the information must pass through 2 intermediary servers, increasing the overall processing load. *We do not recommend this method.*

---++ Setting up the <nop>cluster from the web server

On your web server's WHM interface:
   1 Navigate to the _Configure Cluster_ screen. 
   1 Under _Servers in your DNS Cluster_, locate the _Add a new server to the cluster_ box.<br /><br /><img src="%ATTACHURLPATH%/newserver1.png" width='344' height='120'  alt="Image of the 'Add a new server to the cluster' box." /><br /><br />
   1 Select the server type from the drop-down menu.
   1 Click _Configure_. WHM will display the _cPanel DNS Remote Configuration_ screen. 
   1 Next to _Remote cPanel & WHM DNS service_, type the hostname or IP address of the nameserver you wish to link to.
   1 Next to _Remote server username_, type the WHM username for the nameserver (either =reseller= or =root=).
   1 Under _Remote server access hash_, enter the nameserver's remote access key. 
      * You can generate and retrieve a key using the nameserver's WHM interface. Log into WHM on the nameserver, and navigate to _Manage SSH Keys_. Once the key appears, cut and paste it into the _Remote server access hash_ box.<br /><br /><img <img src="%ATTACHURLPATH%/remoteconfig1.png" width='848' height='534' alt="Image of the 'cPanel DNS Remote Configuration' screen." /><br /><br />

---++ <nop>DNS Clustering with SoftLayer and VPS.NET

cPanel & WHM users can use the SoftLayer and VPS.NET hosted DNS systems within the WHM interface.  To enable DNS clustering with SoftLayer or VPS.NET, you must obtain an API username and key from [[http://sldn.softlayer.com/article/Getting-Started][SoftLayer]] or [[https://api.vps.net/api/][VPS.net]], respectively.  Once you have done so, follow these steps:
 
   1. Login to WHM.
   1. Select _Cluster/Remote Access_.
   1. Select _Configure Cluster_.
   1. In the _Backend Type:_ menu, choose _SoftLayer_ or _VPS.NET_ 
   1. Click _Configure_.

For more information, please visit the cPanel & WHM [[http://cpanel.net/cpanel_expands_its_dns_cluster_functionality_with_softlayer_and_vpsnet./][Marketing Page]]

---++ Setting up a reverse trust relationship

   1 Select _Setup Reverse Trust Relationship_ if you want WHM to automatically configure the cluster on the remote server.
      * If you select this option, you will not need to log into the WHM _Configure Cluster_ screen on the remote server. However, you may do so if you wish to modify the remote server's cluster configuration.
      * Selecting this option will set the remote server's DNS role to _Standalone_.
   1 Select _Debug mode_ if you want WHM to record DNS clustering transactions in the =/usr/local/cpanel/logs/error_log= file.

---++ Specifying the web server's <nop>DNS role

Next, you must specify that you wish for this server to synchronize changes, or to write DNS data onto the nameservers in the cluster.

   1 Next to _DNS role_, select _Synchronize_. This will cause the web server to send DNS data to the nameserver.
   1 Click _Submit_.

The cluster is now set up. When you return to the WHM _Configure Cluster_ screen, the remote server will be listed in the _Servers in your DNS Cluster_ table.

---++ Important notes about setting up the <nop>DNS <nop>cluster

   * We do not recommend setting up the nameserver to synchronize data to a web server; this will create extraneous zones on the web server. (This means that you do not need to log into WHM on the nameserver and set the web server's _DNS role_ to _Synchronize changes_).
   * You do not need to link dedicated nameservers to each other.
   * A cPanel DNSONLY server should almost *never* be set to _Synchronize changes_ to a web server. The web server should always be set to synchronize to the DNSONLY server(s), and the DNSONLY server(s) should always be set as _Standalone_.

<!--
   * Set PAGETITLE = Guide to DNS Cluster Configuration
-->
Topic revision: r30 - 12 Feb 2013 - 20:44:56 - Main.LaurenceSimon