Greyware Automation Products, Inc.
Greyware Automation Products, Inc.      
     Home    Products    Store    Downloads    Customer Service    Search    
Log in  or   Create an account now -- FREE!        
Domain Time II > v5 > Configuration > Server > Registry Settings

Pricing   Buy Now

Download
30-Day Trial Version
Registry Settings  Registry Settings
Domain Time II Server
Version 5.2

Domain Time Server keeps its settings in the Windows Registry. Most of the service options are best set using the Domain Time Server Control Panel applet. However, some advanced options can only be set by changing the registry. This page explains many of these special registry entries used by Domain Time Server.

CAUTION:
Modifying Registry entries requires basic familiarity with the Windows Registry and its operations. Incorrect changes to the Registry can result in unpredictable, perhaps non-repairable, damage. We cannot be responsible for registry problems.

The Domain Time II Server settings are located in these keys (click the names to jump to details):

   HKEY_LOCAL_MACHINE
      Software
         Greyware
            Domain Time Server
               Enabled Protocols
               HTML
               Keyring
               Logs and Alerts
               Parameters
               Time Sources

 

Enabled Protocols
     
    The Domain Time II Server Enabled Protocols settings are located in this key:

       HKEY_LOCAL_MACHINE
          Software
             Greyware
                Domain Time Server
                   Enabled Protocols


    The values listed in the Enabled Protocols registry key represent the protocol types Domain Time will listen for. They correspond to checkboxes on the Serve the Time and Status Reports property pages of the Control Panel applet. You should not make manual changes to this key or its subkeys.

 

HTML
     
    The Domain Time II Server HTML settings are located in this key:

       HKEY_LOCAL_MACHINE
          Software
             Greyware
                Domain Time Server
                   HTML


    If you enable the Domain Time over HTTP protocol to be served by the Domain Time II Server, Domain Time will optionally provide both a human-readable stats web page (when the server is visited by a browser) and/or a compact time data packet (when the server is queried by a Domain Time Server or Client).

    You may add a custom header and footer to the human-readable web page. For example, everything on tick.greyware.com and tock.greyware.com outside the rectangular frame is either a custom header or footer.

    The custom header and footer are optional. Add them to the registry as follows (you will have to create the HTML registry key and Header and Footer values manually):

Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Header
 
REG_MULTI_SZ
 
(blank)
 
Any HTML you want to appear above the time display

This key and value do not exist unless you create them. Whatever HTML you place in the Header and Footer values will appear on the web page along with the standard logo and status report. If you include a <body...> statement in the Header value, Domain Time will use your <body...> tag instead of its own.

Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Footer
 
REG_MULTI_SZ
 
(blank)
 
Any HTML you want to appear below the time display

This key and value do not exist unless you create them.

Value Name:
 
Value Type:
 
Default Data:
 
Notes:
robots.txt
 
REG_MULTI_SZ
 
(see Notes below)
 
This sets the contents of the robots.txt file provided by the HTML server.

Use this value to control whether search engines should index your time server's web page.

Default contents:

    User-agent: *
    Disallow /
    Disallow *
Value Name:
 
Value Type:
 
Default Data:
 
Notes:
style.css
 
REG_MULTI_SZ
 
(see Notes below)
 
This value contains the CSS code used to style the HTML status web page.

Default contents:

    body {background:#e0ddd0; margin:15px 0px}
    table.main {background-color:#ffe; border-collapse:collapse; border:solid #000 0px; width:95%; margin:0px; margin-left:auto; margin-right:auto;}
    table.main td {padding:0px 1%; line-height:130%;}
    .maintop {font: bold small sans-serif; text-align:left; color:#fff; background-color:#18204f; height:40px;}
    .mainleft {font:x-small sans-serif; text-align:center; vertical-align:top; background-color:#ffe;}
    .mainright {font:x-small sans-serif; text-align:center; color:black; vertical-align:middle; background-color:#ececee;}
    .mainbottom {font:bold x-small sans-serif; text-align:right; background-color:#18204f; height:40px;}
    table.left {background-color:#ffe; width:100%;}
    table.right {background-color:#ececee; width:100%;}
    .l {text-align:right;}
    .r {text-align:left;}
    .refresh {display:block; float:right; margin:0 5px 0 0; background-color:#18204f; cursor:pointer; padding:5px 1%; border-top:1px solid #999; border-left:1px solid #888; border-right:1px solid #444; border-bottom:1px solid #666; line-height:120%; text-decoration:none; color:#ccc;}
    a:hover {background-color:#456; color:#ffe;}
    hr {border:0; color:#000; background-color:#999; height:1px; width:70%; text-align:center; vertical-align:top;}

 

Keyring
     
    The Domain Time II Server Keyring settings are located in this key:

       HKEY_LOCAL_MACHINE
          Software
             Greyware
                Domain Time Server
                   Keyring


    The values listed in the Keyring registry key contain various items related to authentication. They correspond to settings on the Symmetric Keys property page of the Control Panel applet. You should not make manual changes to this key or its subkeys.

 

Logs and Alerts
     
    The Domain Time II Server Logs and Alerts settings are located in this key:

       HKEY_LOCAL_MACHINE
          Software
             Greyware
                Domain Time Server
                   Logs and Alerts


    The values listed in the Logs and Alerts registry key contain various items related to authentication. They correspond to settings on the Logs, Windows Event Viewer, Syslog, SNMP, and Status Reports property pages of the Control Panel applet. You should not make manual changes to this key or its subkeys.

 

Parameters
     
    The Domain Time II Server Parameter settings are located in this key:

       HKEY_LOCAL_MACHINE
          Software
             Greyware
                Domain Time Server
                   Parameters


    The values listed in the Parameters registry key control a wide variety of Domain Time functions. In most cases, they are auto-generated or correspond to settings on the property pages of the Control Panel applet. In general, you will not need to make manual changes to this key or its subkeys.

    However, some values require additional explanation or control functions not exposed on the Control Panel. Those items are listed here.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Allow Browser-based HTTP requests
 
REG_SZ
 
True
 
True or False
 
Controls whether or not this Server will allow browsers to contact the server's built-in web server to view the running server statistics.

The Domain Time II over HTTP protocol must also be enabled on the Serve the Time property page of the Control Panel applet.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Allow Client-based HTTP requests
 
REG_SZ
 
True
 
True or False
 
Controls whether or not this Server will allow Domain Time II Clients to obtain the time via the Domain Time over HTTP protocol.

The Domain Time II over HTTP protocol must also be enabled on the Serve the Time property page of the Control Panel applet.

Note: This setting has a more limited scope than in versions prior to 5.1; it only applies to Client access. In earlier versions it also controlled Server and browser access. See the Allow Server-based HTTP requests and Allow Browser-based HTTP requests values for enabling these items individually in v5.1 and above.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Allow Server-based HTTP requests
 
REG_SZ
 
True
 
True or False
 
Controls whether or not this Server will allow Domain Time II Servers to obtain the time via the Domain Time over HTTP protocol.

The Domain Time II over HTTP protocol must also be enabled on the Serve the Time property page of the Control Panel applet.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Allow Remote Timezone Change
 
REG_SZ
 
True
 
True or False
 
Enables Domain Time II Manager to change the timezone on this machine.
Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Allow Stepping
 
REG_DWORD
 
Varies
 
New as of v5.1, this value is a hex bitmap representing the settings made on Stepping Options dialog of the Clock Control property page. Do not edit this value.

These values will be overridden if the Never Step Clock setting (see below) is enabled.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Clock Change Monitor
 
REG_SZ
 
True
 
True or False
 
If enabled, Domain Time monitors changes to the system clock made by other programs (including the foreground user changing the time or date with the Control Panel applet or the command-line TIME and DATE commands). When the Clock Change Monitor is enabled on a Server and the clock changes unexpectedly, the Server will immediately resynchronize with its time source(s).

You may turn the Clock Change Monitor off if your setup requires having machines with different times (usually only in labs or testing environments). If Clock Change Monitor is disabled and you change a machine's time, it will stay changed until the next cascade signal or regular sync interval. Changes take effect immediately, and may be made by editing the registry or remotely from Domain Time II Manager.

Value Name:
 
Value Type:
 
Default Data:
 
Range:
 
Notes:
Clock Change Sensitivity
 
REG_DWORD
 
0
 
0-255
 
This value represents the number of seconds the system clock must differ from the expected value in order for Clock Change Monitor to decide an unauthorized change has been made to the system clock.

If not present or set to zero, Domain Time will use a value of 2 seconds.

Increase this value only if Clock Change monitor is triggering on normal clock drift (unlikely). Decrease this value only if Clock Change Monitor is not flagging known clock change events by another user or process.

Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Current Version
 
REG_SZ
 
Varies
 
This value is set by the system for informational purposes. Changing it has no effect.

Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Daytime Format
 
REG_SZ
 
NIST
 
Specifies that Server will adhere to the NIST format for the Daytime (RFC-868) protocol.

Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Daytime Identifier String
 
REG_SZ
 
UCT(DOMTIME)
 
Sets the text identifier string sent in responses to time requests using the Daytime (RFC-868) protocol.

Value Name:
 
Value Type:
 
Default Data:
 
Range:
 
Notes:
DT2 Bias in Milliseconds
 
REG_SZ
 
+0
 
-3600000 to +3600000
 
Corresponds to offset from the correct time, in milliseconds, the server will use when serving the time to clients or other servers using the Domain Time II or Domain Time over HTTP protocols. Useful chiefly for situations where you need the network to lead or trail the server by a set amount. This setting does not affect the server's own time, or the time it serves using protocols other than DT2.

This is a REG_SZ value, not a binary or DWORD value. Express the offset using a plus sign or a minus sign, followed by the number of milliseconds you want. Note: Variance reports are not affected by this setting. Do not set up multiple servers with different offsets! Changes to this setting take effect upon restart. The domtimes.log will indicate a warning message if this value is set to anything other than +0.

Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Ephemerides
 
REG_DWORD
 
N/A
 
This value is used by the system. Do not edit.
Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Machine Statistics
 
REG_BINARY
 
N/A
 
This binary value contains the statistics, as of the last update, that can be viewed from DTCheck, the Domain Time II Manager, or the system tray icon. Do not edit.
Value Name:
 
Value Type:
 
Default Data:
 
Range:
 
Notes:
Max Slew Correction (milliseconds)
 
REG_DWORD
 
30000 (decimal)
 
1 to 36000000 (decimal)
 
This value specifies the upper limit, in milliseconds, of variance that Domain Time will attempt to correct by slewing instead of stepping the clock. This setting affects both forward and backward clock adjustments.

The older registry entry controlling this function, Max Slew Correction (seconds), has been deprecated.

If the correction to be made is larger than this setting but less than the allowed MaxDisparity setting (Correction Limit), Domain Time II will step the correction (unless Never Step Clock is enabled, at which point no correction is made and a note to this effect will be entered in the Domain Time logs). See the Never Step Clock and Override Max Disparity registry settings for more info.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Never Step Clock
 
REG_SZ
 
False
 
True or False
 
When enabled, causes Domain Time to make clock corrections only by slewing. This prevents the clock from being stepped to make corrections such as those normally done during startup or from Clock Change Monitor, manual sync triggers, etc.

CAUTION: Enable this option with care. Use of this option may prevent Domain Time from successfully being able to synchronize with a time source if the time correction is too large to accomplish using slewing. See the Max Slew Correction (milliseconds) registry setting for more info.


IMPORTANT: Unlike with versions prior to v5.1, the behavior of this setting is NOT modified by the Override Max Disparity registry setting. If Never Step Clock is enabled, the clock will never be stepped, regardless of any other settings.

As of v5.1,, Domain Time uses the Allow Stepping setting (see above) to provide greater control of the stepping process. If your machine running an older version of Domain Time had Never Step Clock specified in the registry, the value will be translated to an Allow Stepping value of zero when upgrading to v5.x or later. See the Stepping Options dialog of the Clock Control property page to set the options.

In most cases, it is better to set the Stepping Options with the behavior you want than to enable Never Step Clock.


Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
NTP Server RefID
 
REG_SZ
 
Dynamic
 
Dynamic or manually-selected
 
Determines how the NTP RefID field (used to indicate the reference time source) is populated in NTP packets. Dynamic is the appropriate setting under most circumstances, which lets Domain Time decide what is a correct response. Change this value only if the automatically-selected RefID causes problems for NTP clients.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
NTP Server Stratum
 
REG_DWORD
 
Various
 
0 through 15 (decimal)
 
Specifies the NTP Stratum of this Server. A value of 0 means automatic assignment.

Domain Time will assign a default Stratum depending on the type of Server Role selected:

  • Master Server: Stratum 2
  • Slave Server: Stratum 3
  • Independent Server: Stratum 2

You may specify a different value if it better fits your time distribution configuration.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Override Max Disparity
 
REG_DWORD
 
Not present (same as zero)
 
0, 1, 2, 3, or 4
 
Controls how Domain Time decides when to override the Correction Limits set in the Control Panel applets for Server, Slave, or Client Timings as explained below. This allows for setting the clock under certain conditions that would otherwise prevent a correction.


IMPORTANT:
As of v5.1, none of these settings modify the Never Step Clock setting (see above). Note that this is a change in behavior from older versions. Enabling Never Step Clock effectively limits corrections to the Maximum Slew Correction (milliseconds) value, even if a larger correction would otherwise be permitted by Override Max Disparity.

  • 0 or not present (Auto)
    Domain Time will override the disparity settings during startup, on Clock Change Monitor event detection, receiving sync triggers/cascades from management components, or from Control Panel applet (CPL) signals.

  • 1 (Always)
    Domain Time will always override the disparity settings. This is the same as not having disparity settings at all. Always honors Never Step Clock setting.

  • 2 (Never)
    Domain Time will never override the disparity settings. Always honors Never Step Clock. This option may prevent your machine from syncing until you manually set the time to within the set Min/Max disparity range. If the machine is a Domain Time Server, it will normally refuse to serve the time until its own time has been set, so selecting a value of 2 may impact your entire network.

  • 3 (Startup only)
    Domain Time will override the disparity settings only until the first time after startup that it has set its own time correctly. Thereafter, it behaves as if you had set the option to 2.

  • 4 (Limit CCM)
    Clock Change Monitor signals do not override the disparity settings. Startup, management, or CPL signals will override the disparity settings.

Changes to this value take effect immediately. You do not have to stop and restart the service or reboot the machine.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Override Sanity Checks
 
REG_DWORD
 
False
 
True or False
 

To prevent accepting obviously-wild time corrections, Domain Time will (by default) refuse to set the time outside of a defined range of acceptable correction. Backwards-correction is limited to the build date of the software - 1 year. Forward-correction is limited to 11:59:59 on 12/31/2036 due to NTP and UNIX Year 2038 date calculation issues.

However, Windows itself will allow setting the local clock outside of this sanity-checked range. Set this value to True to permit Domain Time to set the clock to any time/date the operating system will allow.

CAUTION: Change this value only if you have a clear requirement to do so.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Server Answer IP
 
REG_MULTISZ
 
(blank)
 
Blank, or a list of one or more IP addresses
 
This value corresponds to the "Listen only on these addresses" list on the Network tab of the Control Panel applet. If this value is not present or is blank, Domain Time will answer on all IP addresses bound to all interfaces present on the machine. Otherwise, Domain Time will only bind to the IP addresses you provide. You may provide IPv4 or IPv6 addresses, and may also use NetBIOS or DNS names. The addresses/names you provide must exist and be permanantly assigned to the machine. This setting is useful chiefly in situations where the machine is multihomed and you want Domain Time restricted to particular interface(s). This setting affects all listening ports for Domain Time Server, unless individual protocols are overridden (see below). You must restart the service (or reboot the machine) for changes to take effect.

Note: Because this value is highly machine-specific, it is not included in template imports or exports. You must set it individually on each machine.

As of version 5.2.b.20130221, you may also use CIDR notation to specify ranges of addresses. For example, 192.168.10.0/24 would bind to any address between 192.168.10.1 and 192.168.10.254, as long as one or more of those addresses was assigned to the machine. This is useful for machines using DHCP: you may restrict Domain Time to a particular network without knowing what IP the machine will have.

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Server Answer IP Override DT2
 
REG_MULTI_SZ
 
(blank)
 
Blank, or a list of one or more IP addresses for use with DT2/udp and DT2/tcp protocols
 
Requires version 5.2.b.20130221 or later. If this value is not blank, Domain Time will use it to bind to the IP addresses you specify for use by DT2 traffic. As with "Server Answer IP" above, you may use CIDR notation to specify networks without specifying individual IPs. Unlike "Server Answer IP," this value is included in template imports and exports. This value is not configurable using the Control Panel applet. You must restart the service (or boot the machine) for changes to take effect.
Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Server Answer IP Override NTP
 
REG_MULTI_SZ
 
(blank)
 
Blank, or a list of one or more IP addresses for use with NTP
 
Requires version 5.2.b.20130221 or later. If this value is not blank, Domain Time will use it to bind to the IP addresses you specify for use by NTP traffic. As with "Server Answer IP" above, you may use CIDR notation to specify networks without specifying individual IPs. Unlike "Server Answer IP," this value is included in template imports and exports. This value is not configurable using the Control Panel applet. You must restart the service (or boot the machine) for changes to take effect.
Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Server Answer IP Override PTP
 
REG_MULTI_SZ
 
(blank)
 
Blank, or a list of one or more IP addresses for use with PTP
 
Requires version 5.2.b.20130221 or later. If this value is not blank, Domain Time will use it to bind to the IP addresses you specify for use by PTP traffic. As with "Server Answer IP" above, you may use CIDR notation to specify networks without specifying individual IPs. Unlike "Server Answer IP," this value is included in template imports and exports. This value is not configurable using the Control Panel applet. You must restart the service (or boot the machine) for changes to take effect.
Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Server Settings
 
REG_BINARY
 
N/A
 
Used internally. Do not edit.
 

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Service Installed
 
REG_SZ
 
N/A
 
True or False
 
Used internally. Do not edit.
 

Value Name:
 
Value Type:
 
Default Data:
 
Notes:
Service Log Filename
 
REG_SZ
 
[not present]
 
Sets the location and name of the service log file. If this value is not present or is blank, the log file will be created with the default filename domtimes.log in the %SystemRoot%\System32\ folder. The complete path and filename must be specified (i.e. C:\Windows\System32\domtimes.log) and the drive specified must be a local drive.
 

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Service Running
 
REG_SZ
 
N/A
 
True or False
 
Used internally. Do not edit.
 

Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Set Processor Affinity
 
REG_DWORD
 
0
 
00-FF (hex)
 
If not present or set to zero, Domain Time will not attempt to restrict time-sensitive operations to any particular processor in a multi-processor system. In some systems, the majority of hardware interrupt handling occurs on only one processor (typically processor 0), so it may provide increased accuracy if Domain Time uses only other processors during time-sensitive operations. This value is a hex bitmap representing the processors in the system, with bit 0 representing the first processor, bit 1 representing the second processor, and so forth.
Value Name:
 
Value Type:
 
Default Data:
 
Options:
 
Notes:
Test Mode
 
REG_SZ
 
False
 
True or False
 
Corresponds to the Test Mode checkbox on the Advanced property page of the Control Panel applet. If enabled (True), Domain Time will go through all the motions of obtaining the time and calculating variances, but will not actually set the clock. If disabled (False, the default value), Domain Time will set the clock after obtaining the time from its time source(s). Changes to this value only take effect after restarting the service.
Value Name:
 
Value Type:
 
Default Data:
 
Notes:
TIME/ITP Offset (seconds)
 
REG_DWORD
 
2208988800 (decimal)
 
Used internally by the system. Do not change this value unless instructed to do so by tech support.

Time Sources
     
    The Domain Time II Server Time Sources settings are located in this key:

       HKEY_LOCAL_MACHINE
          Software
             Greyware
                Domain Time Server
                   Time Sources


    The values listed in the Time Sources registry key represent the time sources Domain Time uses to obtain the time. They correspond to settings on the Obtain the Time property page of the Control Panel applet. You should not make manual changes to this key or its subkeys.

 

Back Back to the System Tray Applet page

My Account  |   Contact Us  |   Feedback to Greyware  |   Privacy Policy  |   Printer-Friendly Version
 
Copyright © 1995-2013 Greyware Automation Products, Inc.  All Rights Reserved
All Trademarks mentioned are the properties of their respective owners.