VMmanager: Administrator guide

Integration with DNSmanager 6 module

For some Internet services (e.g. sending email), on servers it is necessary to convert IP addresses into domain names. To perform this conversion, you need to configure DCImanager 6 integration with the DNS server.

DCImanager 6 supports integration with DNSmanager 6 control panel. DNSmanager 6 uses the built-in PowerDNS DNS server. After the integration, PTR records will be created on the DNS server, converting servers addresses into domain names.

If the Integration with PowerDNS module was installed in the platform, it will be removed after the integration with DNSmanager 6 is configured.

Matching of IP address and reverse domain name

To determine a domain name by IP address, the DNS server uses a PTR record of the reverse domain zone. To execute the request, the node address is converted to the reverse form. The translation method depends on the IP version.

IPv4

IPv4 address is written as four decimal numbers from 0 to 255, separated by dots. E.g., 192.168.0.1. To search for domain names by IPv4 addresses, the domain "in-addr.arpa." is used. The IP address is written in the domain name in reverse order. For example, the address 195.161.72.28 corresponds to the domain name "28.72.161.195.inaddr.arpa.".

IPv6

The IPv6 address is written as eight hexadecimal numbers from 0 to ffff, separated by colons. E.g., 3107:0c38:0a67:0000:0000:e446:3925:0091. To search for domain names by IPv6 addresses, the domain "ip6.arpa." is used. The IP address is written in the domain name in reverse order. For example, the address 3107:0c38:0a67:0000:0000:e446:3925:0091 corresponds to the domain name "1.9.0.0.5.2.9.3.6.4.4.e.0.0.0.0.0.0.0.7.6.a.0.8.3.c.0.7.0.1.3.ip6.arpa".

Integration setup

During the integration process, the IPmanager 6 module will create the necessary zones and NS records in DNSmanager 6. This step can take a considerable amount of time.
  1. On the server with DNSmanager 6:
    1. If necessary, update the control panel to at least version 6.1.0.
    2. Create a user for integration with the User or Reseller access level.
  2. On the server with the platform:
    1. Install the "Integration with DNSmanager 6" module: in the right menu, click the icon → Modules section → Integration with DNSmanager 6 module → Install button.
    2. Configure the module:
      1. Click Configure button.
      2. Specify connection settings for DNSmanager 6:

        1. Server Address.
        2. Username.
        3. Password.
      3. Click Apply button.
    3. If you have configured integration with other platforms via the Integration with IPmanager 6 module, install the Integration with DNSmanager 6 module with similar settings:
      1. In all integrated VMmanager platforms.
      2. In the integrated DCImanager 6 platform, if it is a master.

Updating the module

Updates for the module are not installed automatically. To update the module, click the   icon in the right menu → Modules → Integration with DNSmanager 6 → Update button. 

Diagnostics

DCImanager 6 integration with DNSmanager 6 is performed by the DNSProxy service. The log files of the service are in the docker container:

  • on the server with DCImanager 6 — dci_dns_proxy_1;
  • on the server with VMmanager vm_dns_proxy_1.

List of service log files:

  • /var/log/dns_proxy_integration.log
  • /var/log/dns_proxy_service_1_reader.log
  • /var/log/dns_proxy_service_1_writer.log

Issues in module operation may also be related to the task processing service. To diagnose the problem, examine stdout of the container:

  • on the server with DCImanager 6 — dci_taskmgr_1;
  • on the server with VMmanager — taskmgr.