DNS settings

From ISPWiki
Jump to: navigation, search

DNS main parameters

You should specify a number of configuration file parameters to configure DNS settings. These parameters are responsible for location of certain programs or configuration files. Each parameter has a default value. We recommend that you not modify them unless you have issues in using modules of your control panel.



It is used to specify the type of the DNS server. Possible values:

  • DNS named - use the BIND DNS-server (or built-in named for FreeBSD).
  • DNS nsd - use the NSD DNS-server
  • DNS pdns - use the PowerDNS DNS-server.
  • DNS remotedns - use remote DNSmanager as the DNS server
  • DNS msdns - use Microsoft(R) DNS Server (only for Windows Server(R) 2008).

Use the following format:

path internal_name full_path

Parameters that are used for all name servers:

  • DomainTTL - time to life of the resource records (the default value is "3600").

The following parameters are used for BIND:

  • DomainZonesPath - directory where domain zone files are stored.
  • DomainSlaveZonesPath - directory where domain zone files are stored, if the panels are used as slave DNS.
  • named.conf - location of the named (DNS) configuration file.
  • NamedChrootDir - location of the directory where named (DNS) creates chroot on some operating systems.
  • ndc - location of the program that is responsible for DNS server.

The following parameters are used for PowerDNS:

  • PdnsConfigDir - directory containing configuration files for starting PowerDNS processes.
  • PdnsDBHost - hostname that is used for connecting to MySQL ("localhost" is used by default).
  • PdnsDBUser - username that is used for connecting to MySQL ("root" is used by default).
  • PdnsDBPassword - password for connecting to MySQL.

The following parameters are used for NSD:

  • NsdUser - username that is used for starting NSD processes.
  • NsdConfigDir - path to the directory containing configuration files of NSD server copies.
  • NsdChrootDir - path to the chroot-directory (if the NSD processes start in the chroot-environment).
  • NsdChrootDir - path to the directory where databases of the NSD server copies are located.
  • NsdRunDir - path to the directory where pid-files of the process-copies of the NSD server are located.

The following parameters are used if DNSmanager is used as the DNS server:

  • RemoteDNSUser - user of remote DNSmanager that is used as the DNS server.
  • RemoteDNSPassword - password of the user of remote DNSmanager that is used as the DNS server.
  • RemoteDNSURL - URL to the control panel (remote DNSmanager) that is used as the DNS server.

DNS service parameters

For implementation of internal logic of the DNS module and support for certain DNS-servers the following service parameters are used.

Warning! We recommend that you not add or edit those parameters manually. Such changes may disturb normal operation of the DNS module!

  • DefViewUsable
  • DefViewAlias

If you detected that some DNS zone already exist while creating the first view, you should locate those zones into any view. The default view will be created and an IP address will be assigned. The previously created DNS zones will be transferred to that view. If the main IP address of the server is assigned to the newly created view, you should decide whether to allow for such a view or not. The corresponding form will be shown in the user interface. The DefViewUsable parameter set to yes allows for the default view. In this case the name of the new view will be specified in the DefViewAlias parameter and the default view will be used. It is unsafe to use this method, as all of the zones previously created on the DNS server will be available in the newly created view. If the user doesn't want to use the default view, the DefViewUsable will be set to no.

For the NSD server in the configuration file of each server copy the following record will be specified in the server section when configuring trusted DNS servers (allow-transfer):

###ISP_DNS_VALUE allow-transfer {list of IP addresses}

The list of IP address is a string where the " " symbol (space) is used as the separator. Use the set_empty string for specifying an empty string.

This parameters enables to implement internal logic of general configuration of trusted DNS server for view (NSD copy), as NSD logic enables to specify this parameter only on the domain zone level.

When using remote DNSmanager as the DNS server, developers of the control panel must specify a login level of the DNSmanager user that will set up integration. Specify the following parameter:

  • RemoteDNSRequiredLevel

Possible values "admin", "reseller", "user". Currently only the "User" login level is available.

When setting up integration with remote DNSmanager it can appear that the local database of the DNS module does not contain information about DNS entities (for example, domain zones), while remote DNSmanager has information about some DNS entities. In that case the administrator should decide which logic to use for synchronization. That information is specified in the parameter:

  • RemoteDNSOnSync

Possible values: "sync" means that the information about DNS entities is put into the local database, or "remove_remote" means that all the data are removed from remote DNSmanager

IP addresses for NS-servers

If the NS-record lies within the domain zone created. A and AAAA records will be created automatically for NS-servers.

  • NsIps - ip-addresses space separated. You can both ipv4 and ipv6 addresses.

If this parameters is specified in the ISPmanager or DNSmanager configuration file, ip-addresses for ns-records will be taken from the file.

If the parameter is not specified, IP-address of the master zone will be taken for the first NS-record, master-зоны, ip-address of the slave-zone will be used other records (you can see them in the External name servers module in ISPmanager or in the Slave name servers module in DNSmanager).