Single DNS Configuration

Last modified: 27 Dec 2007

Single DNS configuration enables to allocate two or more DNS servers on one physical box. In this mode, H-Sphere emulates full-featured DNS configuration where each DNS server has its own bound IP. This allows customers with a single box installation to use services, such as OpenSRS domain registration, that require at least two DNS servers.

WARNING:
Single DNS mode is available only if all DNS servers are configured on one physical box! You cannot have two DNS logical servers on one box if you have another DNS server on a separate box.

To put an extra DNS server to single DNS configuration, go through the following steps:

H-Sphere 2.5 and up

1. Add another DNS logical server to the physical server with DNS.
2. Log in as cpanel user and run the following java tools:
   • ClusterPreparer:
     
     su - cpanel -c "java psoft.hsinst.boxes.ClusterPreparer"
   • DNSCreator:
     
     su - cpanel -c "java psoft.hsphere.tools.DNSCreator -m rand"
     Read more about DNSCreator options.
3. Execute:
   /hsphere/local/config/bind/scripts/config_bind
4. Restart named service.

H-Sphere 2.4.x

1. Log into the server as root:

   su -l

2. Bind the new DNS server IP on the physical box.
3. Add this new IP to the listen-on section of the named configuration file (/etc/named.conf for Linux, /etc/namedb/named.conf for FreeBSD):
   

   options {
   ...
   listen-on { ... new-IP; ... };
   ...
   };

   Read more about DNS configuration.
4. Copy the three scripts from the /hsphere/shared/scripts/SingleDNS/ directory into the /hsphere/shared/scripts/ directory replacing the existing scripts.

   cd /hsphere/shared/scripts/SingleDNS/
   cp * ../
   cd ..

5. Run the fix_perm.sh script to set correct permissions to H-Sphere scripts:
   

   ./fix_perm.sh

6. Add the new DNS logical server.
7. In DNS manager, add custom A record with the new DNS logical server.
8. Log in as cpanel user and run DNSCreator:
   

   su -l cpanel
   java psoft.hsphere.tools.DNSCreator -m rand

   Read more about DNSCreator options.