(WHM >> Home >> Clusters >> DNS Cluster)
A DNS cluster is a group of nameservers that share records, which allows you to physically separate nameservers that handle the DNS requests from your web servers. This interface allows you to configure a DNS cluster and add servers to an existing DNS cluster.
For more information about the types of DNS cluster configuration and why you may wish to use a DNS cluster, read our Guide to DNS Cluster Configurations documentation.
To configure your DNS cluster, you must meet the following minimum requirements:
cPanel & WHM does not support DNSSEC in DNS clusters.
To modify DNS cluster settings, log in as the
root user. If you log in as a reseller, you will not see the DNS Clustering section of this interface.
To enable or disable DNS clustering in WHM, perform the following steps:
After you enable the DNS Cluster feature, specify which servers you wish to include in the DNS cluster.
The Failure threshold for cluster members setting allows you to specify the number of
dnsadmin commands that may fail before WHM disables an unresponsive DNS cluster member.
To configure the Failure threshold for cluster members setting, perform the following steps:
Select 10 (Default) to use the default option, which allows cluster members to fail up to ten
We recommend that you use this option.
Select the second option to enter a custom failure threshold.
If server down times or network interruptions are common in your hosting environment, we recommend that you increase the failure number count so that the system does not mark certain cluster members as offline. This may also increase server and network load because the system may repeatedly send some DNS requests.
If you wish for WHM to notify you when it disables an unresponsive member in your DNS cluster, select Receive a notification when WHM disables an unresponsive cluster member.
You must manually reenable a disabled cluster member.
If a cluster member in the sync role is offline for an extended period of time, resynchronize the other server's zones. This ensures that the cluster member is up-to-date.
This section allows you to view, add, and delete servers from your DNS cluster.
The Servers in your DNS cluster table displays the following information about each server in your DNS cluster:
|Hostname||The server's hostname.|
|IP address||The server's IP address.|
|Username||The WHM username that you used when you configured this server in the DNS cluster. Typically, this is either |
|Type||The type of server: cPanel, SoftLayer, or VPS.NET.|
|Status||The version of cPanel & WHM that the server currently runs, and an icon that indicates the server's status.|
The server's DNS role. You can choose from the following options:
You can use the menu in this column to change a server's DNS role.
|Actions||You can use the icons in this column to modify a DNS cluster server or to delete a server from the DNS cluster.|
To add a a cPanel & WHM or cPanel DNSONLY server to the DNS cluster, perform the following steps:
Select the server type from the Backend Type menu.
To enable DNS clustering with SoftLayer or VPS.NET, you must first obtain an API username and key from VPS.net or SoftLayer. Then, choose SoftLayer or VPS.NET from the Type menu.
Enter the nameserver's API token hash or remote access key in the Remote server access hash text box.
Enter an API token hash that you saved on your workstation or create a new API token in WHM's Manage API Tokens interface (WHM >> Home >> Development >> Manage API Tokens).
Make certain that after you create an API token, you save the token hash a safe location on your workstation so that you can use it with other features. The API Tokens table in WHM's Manage API Tokens interface ( WHM >> Home >> Development >> Manage API Tokens ) only displays the API tokens' names, rather than the tokens' hashes .
You can find the server's remote access key in WHM's Remote Access Key interface (WHM >> Home >> Clusters >> Remote Access Key).
Select Setup Reverse Trust Relationship for WHM to automatically configure the DNS cluster on the remote server.
Select an option from the DNS Role menu to specify the server's DNS role.
After you add the server to the cluster, synchronize the new DNS server with the other servers in the DNS cluster in WHM's Synchronize DNS Records interface (WHM >> Home >> DNS Functions >> Synchronize DNS Records)
To confirm that the new server functions, run the following command, where
example.com represents the server name, and
ip represents the server's IP address:
dig +short example.com @ip
|We do not recommend that you set up the nameserver to synchronize data to a web server, because this creates extraneous zones on the web server. This means that you do not need to log in to WHM on the nameserver and set the web server's DNS role to Synchronize changes.|
To remove a cPanel & WHM or cPanel DNSONLY server from a DNS cluster, perform the following steps:
When you return to the DNS Cluster interface, the server will no longer appear in the list of servers in the DNS cluster.
You can change a server's DNS role or edit the server's configuration settings at any time.
To edit a server's DNS role, perform the following steps:
To edit a server's configuration settings, perform the following steps: