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 to the System Tray Applet page
|