Parallels H-Sphere Documentation System Administrator Guide


Single DNS Configuration


Related Docs:   Adding DNS Servers DNS Servers (Admin Guide)

Last modified: 27 Dec 2007


WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

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.

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 -m rand"
      Read more about DNSCreator options.
  3. Execute:
  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 script to set correct permissions to H-Sphere scripts:


  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 -m rand

    Read more about DNSCreator options.

Related Docs:   Adding DNS Servers DNS Servers (Admin Guide)

© Copyright 2018. Parallels Holdings. All rights reserved.