HOWTO: Registry Settings for the Microsoft DNS Server

ID: Q164488


The information in this article applies to:
  • Microsoft Windows NT Server version 4.0


IMPORTANT: This article contains information about editing the registry. Before you edit the registry, make sure you understand how to restore it if a problem occurs. For information about how to do this, view the "Restoring the Registry" Help topic in Regedit.exe or the "Restoring a Registry Key" Help topic in Regedt32.exe.

SUMMARY

This article describes settings for the Microsoft Domain Name Service (DNS) Server. You can modify most settings using the DNSADMIN tool, although some settings can only be altered using Registry Editor.


MORE INFORMATION

WARNING: Using Registry Editor incorrectly can cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk.

For information about how to edit the registry, view the "Changing Keys And Values" Help topic in Registry Editor (Regedit.exe) or the "Add and Delete Information in the Registry" and "Edit Registry Data" Help topics in Regedt32.exe. Note that you should back up the registry before you edit it.

To change these parameters, use the following procedure:

  1. Start Registry Editor (Regedt32.exe).


  2. From the HKEY_LOCAL_MACHINE subtree, go to the following key:

    \SYSTEM\CurrentControlSet\Services


  3. From the Edit menu, click Add Value and add a value to the key described in the appropriate entry below. Type in the value, and using the Data Type checkbox to set the value type.


  4. Click OK.


  5. Quit Registry Editor.


  6. Restart the DNS Server for the above changes to take affect.


All of the DNS parameters are registry values located under subkeys of:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
Services\DNS\Parameters


NOTE: The previous registry key is one path; it has been wrapped for readability.

------------------------------------------------------------------

EnableRegistryBoot

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Boolean<BR/>
      Default: 0 (False)<BR/>
      Valid Range: 0,1 (False, True)<BR/>
      Description: Configure the DNS Server to read information about
      Zones either from a Bind style boot file or from the Registry.
<BR/><BR/>
      <B>NOTE</B>: If you return to using a boot file, ALL changes to zone
      information, including new zones, made through the DNS Manager
      will be lost.<BR/> 
Forwarders

      Key: DNS\Parameters<BR/>
      Value Type: REG_BINARY - Binary list of ip addresses.<BR/>
      Default: none<BR/>
      Description: IP address(es) of Forwarder(s).<BR/> 
ForwardingTimeout

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Time in seconds<BR/>
      Default: 5<BR/>
      Description: Timeout in seconds until a forwarded query is
      regarded as unsuccessful.<BR/> 
IsSlave

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Boolean<BR/>
      Default: 0 (False)<BR/>
      Valid Range: 0,1 (False, True)<BR/>
      Description: Configures the DNS Server to be a Slave server.
      Can only be used when the DNS Server is configured to use
      Forwarder(s).<BR/> 
ListenAddresses

      Key: DNS\Parameters<BR/>
      Value Type: REG_BINARY - Binary list of ip addresses.<BR/>
      Default: none<BR/>
      Description: The ListenAddresses key is a list of IP
      addresses for the DNS server to listen on. The list is not
      dotted IP strings, but a counted array of raw addresses in
      net byte order. It should be configured through the
      ServerProperties\Interfaces dialog box in the admin tool.
      Editing the rekey is discouraged. If the ListenAddresses key
      does not exist, the DNS server attempts to bind to every IP
      address on the computer. This is in general desirable
      behavior.<BR/> 
BindSecondaries

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Boolean<BR/>
      Default: 1 Bind compatibility Enabled.<BR/>
      Valid Range: 0,1 (False, True)<BR/>
      Description: Disables (old) Bind compatible Zone Transfer.
      Prior to BIND version 4.9.4, implementations of DNS would send
      one resource record per message to secondary servers. For this
      reason, Windows NT defaults to this standard when sending
      messages to a non-Microsoft secondary DNS Server.
<BR/><BR/>
      If the DNS secondary servers are running BIND version 4.9.4 or
      later, it will be able to send multiple resource records at a time.<BR/> 
CleanupInterval

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Time in seconds<BR/>
      Default: 900 (15 minutes)<BR/>
      Valid Range: 600 - 86400 (ten minutes - one day)<BR/>
      Description: Specifies how often the DNS Server will clean up
      the database from expired entries. The DNS Server will also verify
      that it can find root servers at this interval. If no root servers
      can be found using cached information, the DNS Server will reload
      the cache file.
<BR/><BR/>
     <B> NOTE</B>: The DNS Server will normally only update any cached NS and
      corresponding A entries if current time-to-live (TTL) is less than
      CleanupInterval. (that is, if the entry risks to be removed from the
      cache before next CleanupInterval)<BR/> 
DisableAutoReverseZones

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Boolean<BR/>
      Default: 0 (Create AutoreverseZones Enabled.)<BR/>
      Valid Range: 0,1 (False, True)<BR/>
      Description: By default, when the DNS Server is started, three zones       are always created (In Memory only). These zones are used for       localhost lookups and they should always exist on the DNS Server.
<BR/><BR/>
         0.in-addr.arpa<BR/>
         127.in-addr.arpa<BR/>
         255.in-addr.arpa
<BR/><BR/>
      You should normally never disable this because, if they do not exist,
      lookup to any of these zones will be sent to a root server.
<BR/><BR/>
      As these zones are only created in memory and not stored in any zone
      files, if you need to modify the localhost reverse lookup zone, then
      you need to manually create it. The correct name for that zone is:
      0.0.127.in-addr.arpa<BR/> 
NoRecursion

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Boolean<BR/>
      Default: 0 (Recursion Enabled.)<BR/>
      Valid Range: 0,1 (False, True)<BR/>
      Description: Enables/disables if the DNS Server should do
      recursive lookups to other DNS Servers.<BR/> 
RecursionRetry

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Time in seconds<BR/>
      Default: 2<BR/>
      Description: Specifies number of seconds that the DNS Server
      waits for a recursive query to another DNS Server to return.<BR/> 
RecursionTimeout

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Time in seconds<BR/>
      Default: 15<BR/>
      Description: Specifies maximum number of seconds that the DNS Server
      waits before returning an unsuccessful answer to the client.
<BR/><BR/>
      If RecursionTimeout is set to 15 and RecursionRetry is set to 2,
      then if every query is unsuccessful, the DNS Server will make up
      to eight queries to other DNS servers before returning an             unsuccessful response to the resolver (client). 

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DNS\Zones

Holds information of every configured zone.

Every zone has a registry key under the Zones key.

There will always be a key with the name ".". This key will either refer to the cache file, or if the server is a root server, the zone file for the root domain.

The DNS Server loads the cache from this file when started. The DNS Server will never respond to a query from the cache file. It is used internally in the DNS Server to find root name servers.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\DNS\Zones\(ZoneName)\

DatabaseFile

      Key: DNS\Zones\(ZoneName)\ <BR/>
      Value Type: REG_SZ - String that holds File name.<BR/>
      Default: (zone.dns  i.e. microsoft.com -&gt; microsoft.com.dns)<BR/>
      Description: Name of the database file.
      The file is stored in Winnt\System32\DNS<BR/> 
Type

      Key: DNS\Zones\(ZoneName)\ <BR/>
      Value Type: REG_DWORD - Number 0-2<BR/>
      Default:<BR/>
      Valid Range: 0,1,2<BR/>
      Description: Type of Zone/Database.<BR/>
      0=Cache file, 1=Primary Zone, 2=Secondary Zone.
<BR/><BR/>
      <B>NOTE</B>: If the server is configured as a root server, then the       Type of the Zone file of the "." domain will be set to 1. And the      format of the file has to be the same as any other zone file.
<BR/><BR/>
      <B>NOTE</B>: A root server does not cache resolved queries. It will      always respond from the zone file.<BR/> 
MasterServers

      Key: DNS\Parameters<BR/>
      Value Type: REG_BINARY - Binary list of ip addresses.<BR/>
      Default: none<BR/>
      Description: IP addresses of Master servers. This entry is only
      available for secondary zones. The DNS Server will contact
      servers listed here to request a zone transfer.<BR/> 
SecondaryServers

      Key: DNS\Parameters<BR/>
      Value Type: REG_BINARY - Binary list of IP addresses.<BR/>
      Default: none<BR/>
      Description: IP addresses of secondary servers to be notified
      about changes to the zone. This list is also used if you
      configure the DNS Server to only allow specific servers to
      request a zone transfer (SecureSecondaries).<BR/> 
SecureSecondaries

      Key: DNS\Parameters<BR/>
      Value Type: REG_DWORD - Boolean<BR/>
      Default: 0<BR/>
      Valid Range: 0,1 (False, True)<BR/>
      Description: Allow ONLY in SecondaryServers listed servers
      to function as secondary servers.(Request ZoneTransfer.) 

Additional query words: dns

Keywords : kb3rdparty kbenv kbnetwork kbsample kbsetup kbADO kbASP kbSQLServ NTInterop nttcp ntconfig ntregistry NTSrv
Version : winnt:4.0
Platform : winnt
Issue type : kbhowto


Last Reviewed: May 26, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.