Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview


Plesk DNS DirectAdmin DNS Helper is an extension shipped with Plesk DirectAdmin module to help you connect your Plesk DirectAdmin installations with one of the HostBill-supported DNS services:

  • Power DNS
  • Power DNS Slave Zones
  • OnApp DNS
  • cPanel DNS
  • ...or any other DNS HostBill supports


How it works?

  • In your Plesk DirectAdmin installations you setup DNS templates to use your actual master nameserver (i.e. PleskDirectAdmin, Power DNS, cPanel DNS)
  • You install our Plesk extension DirectAdmin plugin and point it to your HostBill install
  • Any time new zone is created / updated / deleted in PleskDirectAdmin, our extension notifies HostBill about it
  • HostBill then "decides" what to do next. It can:
    • Push this zone to real master nameserver
    • Notify secondary nameserver to create/update slave zone
    • After exporting such zone, HostBill can assign it to the related customer 

So you can have:

  • Slave DNS (any supported by HostBill) notified automatically about new zones in PleskDirectAdmin, or:
  • Plesk DirectAdmin DNS will not be used to handle DNS queries, but as a source of data for actual DNS server that handles requests.
    With this approach you can benefit from flexible & automated DNS templates built into Plesk DirectAdmin on any central DNS server you wish to use with it.

Table of Contents


Configuring HostBill DNS Helper in DirectAdmin


To begin, you need to install Plesk Extension DirectAdmin Plugin that is shipped with Plesk DirectAdmin module for HostBill.

  1. Copy extension zip plugin .tar.gz file from includes/modules/Hosting/plesk12directadmin2/pleskmoduleplugin/dist directory  directory of your HostBill installation. ie: hostbill-dns-1.0-1.zip to your plesk server
  2. Login to your plesk sshDirectAdmin panel, and install extension as instructed in https://docs.plesk.com/en-US/onyx/extensions-guide/extensions-management-utility.73617/ 

    Code Block
    titleSample of extension install
    plesk bin extension -i /root/hostbill-dns-1.0-0.zip
  3. Once extension is installed, click "Go to extension" next to it:
    Image Removed
  4. Configure connection to HostBillSelect your Plesk master IP address (used by primary nameserver on Plesk)

    plugin 


    1. Add a plugin: Extra Features → Plugin Manager → Add

    2. Select File in Upload Method
    3. Select the hostbill_dns.tar.gz file and check the Install after upload option
    4. Install
  5. Once plugin is installed, click Extra Features → HostBill DNS Helper:
    Image Added
  6. Configure connection to HostBill
    1. Enter URL to HostBill API endpoint (described in section below)
    2. Enter Secret to HostBill API (save it for later)
      Image Removed
    3. In field Slave IPs to whitelist, enter comma separated list of IP addresses of your slave servers that should be added to Plesk DNS ACL.
      This is required if target DNS server (configured in HostBill, read below) you will be exporting zones to should be responsible for storing slave zones, while Plesk DNS will serve as storage for master zones.
    4. Submit with OK Image Added
    5. Submit with Save Changes button

You can now verify connection to your HostBill by clicking Test Connection button. If connection succeeds, you should see following message:
Image RemovedImage Added


Configuring

Plesk

DirectAdmin module in HostBill


Make sure that any Plesk DirectAdmin you will be synchronizing data from have configured connection in HostBill → Connect with app (read more about configuration in: Plesk DirectAdmin).

Especially ensure that following fields: 

  • IP address 
  • Secret for DNS toolPrimary nameserver IPs

are configured in your Plesk DirectAdmin connection in HostBill.
Image RemovedImage Added


Configuring

Plesk

DirectAdmin DNS Tool in HostBill



  1. Find and activate Plesk DirectAdmin DNS Tool plugin in your HostBill → Extras → Plugins
  2. Once activated proceed to Extras → Plugins → Plesk DirectAdmin DNS Tool to configure the module
    1. Copy HostBill API endpoint URL to be used on Plesk extension DirectAdmin plugin configuration
      Image RemovedImage Added
    2. Select Target DNS server you wish zones coming from your Plesk DirectAdmin installations should be hosted on
    3. If you'd like your clients to manage their DNS zones in HostBill DNS manager - tick "The module has additional options that are checked during zone synchronization

      • Try to assign

      synchronized
      • imported zone to existing HostBill

      account"
      • DNS management account 

      • Sync DNS only if HostBill domain exist

      • Check if zone exist in target DNS before attempting to creating it

      • Transfer A/CNAME only for free subdomains

      • Do not synch/import zones that already exists in target DNS server

      • Replace/set NS records for zone using target DNS App settings

Info
titleWarning

This option should be used with caution, possibly only for PowerDNS Slave module. If you enable this option, client will "see" imported zone in DNS management section.

If customer would then update anything directly on DNS server, his changes may later be overwritten by another synchronization made with

Plesk

DirectAdmin DNS tool.

It's best to have clients manage their DNS directly on

Plesk

DirectAdmin or via HostBill client portal, using

Plesk

DirectAdmin DNS management function