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: Options: Notes:
|
Display Network Info
REG_SZ
True
True or False
Controls whether or not network information such as IP addresses and the server name are displayed on the web page.
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 logging and alerting functions. 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:
|
Accept First PTP Timestamp
REG_SZ
False
True or False
If set to True and and no other time sources are configured, then the clock will be stepped or slewed if within slewing limits to match the first PTP
timestamp(s) received (the number of samples required are configured using the Accept Firest PTP Sample Count registry entry described below).
This initial correction will bring the clock into close enough sync for normal PTP operations to govern the clock.
Note, on versions prior to 5.2.b.20200930, the clock adjustment was always stepped.
IMPORTANT: Changing this setting to True is discouraged in networks with fallback NTP/DT2 timesources,
since a restart of the service may step the clock, including possibly stepping the clock backwards. This option
should only be used in closed environments where PTP is the only possible source of time and the initial startup
delta takes an excessively long time to correct (i.e. if the motherboard CMOS clock is wrong).
|
Value Name: Value Type: Default Data: Range: Notes:
|
Accept First PTP Sample Count
REG_DWORD
3
1-15
Introduced in v5.2.b.20200930. Applies only if Accept First PTP Timestamp is enabled. Specifies the number of timestamps that must be
received before the clock is adjusted.
|
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: Notes:
|
Client Settings
REG_BINARY
Varies
This value is a hex bitmap of various settings recommended by a Domain Time Master Server to Domain Time Clients. See
the Recommendations page for an explanation
of how they operate.
Note: On Domain Time Client, this key controls miscellaneous settings for the Client itself.
See the Server Settings key for the miscellaneous settings for Domain Time Server.
|
Value Name: Value Type: Default Data: Range: Notes:
|
Clock Adjustment Bucket Size
REG_DWORD
7
3-32
The bucket size is the number of time samples collected before a particular clock adjustment rate is evaluated.
The specified value is used except during accelerated clock training, where a fixed value of 5 is employed.
You should not change this number unless instructed by techsupport.
Important: This is a machine-specific setting and should not be included in installation templates or copied to other machines via mass registry imports.
|
Value Name: Value Type: Default Data: Notes:
|
Clock Adjustment Statistical Method
REG_SZ
Automatic
Sets the type of statistical analysis Domain Time performs on collected time samples from a time source when deciding
whether and how much to adjust the clock rate to compensate for drift. Domain Time then uses the calculated clock
performance to evaluate and remember each integral clock adjustment rate it tries. Changing this value may improve
or degrade timing accuracy (or have no effect).
Changes to this setting take effect immediately after the next group of collected samples is ready for analysis. You do not
need to restart the service. You should clear your clock history using the command dtcheck -resettimings
before changing this value. Allowed values are:
- Automatic - On Vista/2008/Win7/2008r2 machines, Automatic will use the median value
from each group of samples. On all other versions of Windows, it will use the arithmetic mean
(average) of each group of samples.
- Average - The arithmetic mean of values
- Median - The median number in the array of values
- Toss - average of values excluding the highest high and lowest low
- RMS - the quadratic mean (signed root-mean-square) of the array of values
- Disabled - no statistical analysis is retained for future comparison
Important: This is a machine-specific setting and should not be included in installation templates or copied to other machines via mass registry imports.
|
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: Options: Notes:
|
Critical Timing Processor Limit
REG_SZ
Depends on processor type (see below)
True or False
This value is set to False during installation on machines with processors that have an Invariant TSC or if they are a Hyper-V guest; otherwise it is set to True.
When True, Domain Time uses the last-processor-but-one for time-critical events, and any available processor for all other work.
If set to False, Domain Time does not prefer one processor over another for any task.
Modern CPUs (ones with Invariant TSC) generally have better timing performance with this value set to False.
You can check to see if you have an Invariant TSC by running the command-line DTCheck program:
dtcheck -cpuid
|
Value Name: Value Type: Default Data: Notes:
|
Daytime Format
REG_SZ
NIST
Specifies the format that Server will use for the Daytime (RFC-868) protocol. The available options are NIST, NISTLF, or a custom format.
- If set to NISTLF, the output consists of an LF, followed by the normal NIST format string, followed by a space and then a terminating LF.
- If set to plain NIST, there is no leading LF, and the terminator is a CRLF (no extra space).
- You may also use a ddd MMM yyyy format string . Any legal combination of specifiers in Microsoft's GetDateFormat API are acceptable.
|
Value Name: Value Type: Default Data: Options: Notes:
|
Dependent Services
REG_MULTI_SZ
(blank)
Blank, or a list of one or more services you'd like Domain Time to start.
Requires version 5.2.b.20150516 or later. Any services listed here will be started by Domain Time after the
first successful timecheck, as long as the services are set to manual start. This is an alternative to using the
built-in service database's dependencies. If you use the built-in functions, dependent services will wait for Domain
Time to start, but won't know to wait until the first synchronization has completed.
You may list services by their display names (e.g. "Disk Defragmenter") or by their internal service names (e.g.
"defragsvc"). List services one per line, without quotation marks. Domain Time will only attempt to start services
that are listed, not yet running, and set to manual startup.
Important: If Domain Time cannot set the clock for some reason (invalid sources, firewall settings, etc.), then
services you have set to manual start will not be started.
|
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: Range: Notes:
|
ICMP TTL (hop limit)
REG_DWORD
32 (decimal)
1 to 255 (decimal)
This value controls the number of router hops that are allowed in an ICMP echo ("ping") request.
Domain Time pings machines first to help eliminate long waits for machines that are unreachable.
You should only need to adjust this value if you have an LAN/WAN configuration requiring more than the default 32 hops.
|
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: Notes:
|
Min Success Interval (seconds)
REG_DWORD
5
Sets the minimum period allowed between timechecks. Do not change this value.
|
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: Range: Notes:
|
NTP Client Version
REG_DWORD
4 (was 3 on versions prior to 5.2.b.20150516)
1 to 7
Controls the reported NTP version. Any value from 1 to 7 is legal, although using anything but 3 or 4 is not recommended.
|
Value Name: Value Type: Default Data: Options: Notes:
|
NTP Server RefID
REG_SZ
Dynamic
Dynamic or Static
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.
Note: This value is related to and may be overwritten in some circumstances based on the NTP Server Stratum value described below.
When the NTP Server Stratum is set to 0 (Automatic) and NTP Server RefID is set to Dynamic, Domain Time will typically populate the RefID field with the
IP address of its last known time source if the time was derived from a single machine, or 0.0.0.0 if multiple machines were included in the time analysis.
LOCL may sometimes appear under certain configurations for compatibility with Active Directory.
If the NTP Server RefID value is set to Static, the RefID field will typically contain word GREY (or the dotted-quad numeric equivalent).
Setting the NTP Server Stratum to 1 will force the NTP Server RefID to be Static. You may use either Dynamic or Static with any other value of NTP Server Stratum (2 - 15).
Note that when you set the Domain Time Server to "Do not set this machine's time" on the Obtain the Time property page, there is no external time source, so the RefID
field will contain zeros. Some older NTP clients interpret this as the machine not being a valid time source and therefore refuse to synchronize with the Server. In this case,
set the NTP Server Stratum value to 1 and restart the service.
|
Value Name: Value Type: Default Data: Options: Notes:
|
NTP Server Stratum
REG_DWORD
0
0 through 15 (decimal)
Specifies the NTP Stratum of this Server. A value of 0 means automatic assignment.
As of 5.2.b.20150516, when set to automatic assignment Domain Time selects a stratum number based on on strata reported by its
time sources (including PTP, which uses "stepsAway" to correspond, roughly, with NTP strata).
Since Domain Time can use multiple sources with multiple protocols, there may not be an ultimate single stratum from
which time was received. In these cases, Domain Time takes the highest-level stratum reported by all used sources,
and adds one to derive its own stratum number. So, for example, if Domain Time obtains its time from a PTP grandmaster
directly, it will report itself as stratum 2. If it receives its time from three NTP sources, two of which report stratum 1,
and one of which reports stratum 2, Domain Time will report itself as stratum 3. If all three NTP sources reported stratum 1, Domain Time
would report stratum 2, and so forth.
Versions prior to 5.2.b.20150516, automatic assignment applied 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: Notes:
|
Send Port Generic
REG_DWORD
0
Domain Time uses several sockets for generic outgoing messages. By default, the port used is an ephemeral port assigned by the
system. This is the proper behavior for client-server systems; only the server should have a fixed listening port, and clients
should use ephemeral ports. However, in rare cases, other applications have high-number ephemeral ports hard-coded as their
communications ports. If Domain Time happens to start first, and happens to obtain those particular ports, the hard-coded
applications may fail.
Set this value to the beginning port number (n) of a range you want Domain Time to use for its generic outgoing sockets.
Domain Time will attempt to use (n) through (n + 50) to bind its generic outgoing sockets. If none of the ports (n) through
(n + 50) are available, Domain Time will revert to letting the system choose an ephemeral port.
IMPORTANT: Be very careful not to specify any well-known ports or IANA-registered ports for your range, and only set
this value if you have a specific problem that you know will be solved by changing the ephemeral ports Domain Time uses.
|
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
Varies
This value is a hex bitmap of various settings used by Domain Time Server, such as Timings,
Corrections, and other miscellaneous settings.
Note: On Domain Time Client, these functions are located in the Client Settings key.
In general, you should not edit these settings manually. Use the Control Panel applet to configure your settings instead.
However, as of v5.2.b.20170922, the applet setting for Minimum Correction (MinDisparity) has been removed. The setting for this value
defaults to 0x1, but if you upgraded over a previous version with a higher setting, you may edit the binary key to change it. The
Minimum Correction setting is a DWORD, starting at offset 14, stored in little-endian order, as shown below.
The default should be
01 00 00 00, see this example:
|
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)
Note: This value has been deprecated in version 5.x and later; see the Critical Timing Processor Limit value instead.
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.
|
Value Name: Value Type: Default Data: Options: Notes:
|
Time Sample PreFilters
REG_SZ
HighLow
Allowed options are HighLow, Latency, Delta, and Stratum. Prefilters are applied in the order listed; separate filter names with a comma or semi-colon.
Requires version 5.2.b.20150828 or later. This value controls the prefilters used to discard samples before applying
statistical analysis. Prefilters only operate when there are five or more samples available for analysis, and are chiefly
useful when the number of samples is very large, or the sources are unstable. It is best to leave this value at the default,
which eliminates only egregious spikes. Statistical analysis of the entire group of samples usually performs better than
prefiltering more samples out of the mix.
For example, HighLow,Latency would apply first the Highlow filter, then if at least five samples remain, the latency Filter.
Stratum,Latency,Delta would first apply the Stratum filter; then if at least five samples remain, the Latency filter;
then, if at least five samples remain, the Delta filter. Changes to the list of prefilters are recognized only when
parameters are reloaded (server stop/restart, machine reboot, a CPL-initiated sync, or a DTCheck /reload).
Prefilter operations are:
- HighLow (default) - Rejects the most extreme samples, based on absolute magnitude delta (max of 2 samples rejected)
- Latency - Rejects highest latency samples (max 1/3 of samples rejected)
- Delta - Rejects highest magnitude delta (max 1/3 of samples rejected)
- Stratum - Rejects all but the lowest-stratum samples present. Be very careful
with this filter. Example 1: If your selection of samples includes one sample from a stratum 1 server, and
ten more from a mix of stratum 2 and stratum 3 servers, then all but the single stratum 1 sample
would be rejected. Example 2: If your lowest-stratum samples are a mix of stratum 2 servers, then all the stratum 2
samples would survive, but all your samples from strata 3 and up would be rejected. It is probably
better to use the "NTP Client Max Stratum" value introduced in version 5.2.b.20110224 to control
the highest stratum acceptable for NTP sources. The Stratum filter introduced here applies to
all sources that report a stratum, including NTP, DT2, and PTP (the PTP "stepsAway" value is
used to mimic NTP strata, as documented in the release notes for 5.2.b.20150516). Samples that
do not report a stratum are not eliminated by this filter.
|
Value Name: Value Type: Default Data: Options: Notes:
|
Wait for Network Startup
REG_SZ
True
True or False
Present in version 5.2.b.20151102 or later. If set to True, Domain Time will wait up to 30 seconds after boot for an IPv4 address
to be assigned to the machine. At boot time, some network adapter drivers report ready before assigning IP addresses to an
interface, even if the IPs are pre-configured as fixed addresses. DHCP-obtained addresses can take several seconds longer.
The wait period helps ensure that Domain Time's initial enumeration of adapters and IPs is correct before protocol listeners or
timechecks are started.
Change this value only if instructed by Technical 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
Broadcast
PTPv2 (IEEE 1588)
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 or are otherwise automatically set. You should not change items in this
section unless instructed by Tech Support or you are familiar with the specific function.
PTPv2 (IEEE 1588) key
Value Name: Value Type: Default Data: Notes:
|
Current Master
REG_SZ
N/A
Introduced as of version 5.2.b.20160415. Read-only key for use with the Software Development Kit (SDK), purchased separately.
|
Value Name: Value Type: Default Data: Notes:
|
Current Offset (signed 64-bit)
REG_SZ
N/A
Introduced as of version 5.2.b.20160415. Read-only key for use with the Software Development Kit (SDK), purchased separately.
|
Value Name: Value Type: Default Data: Options: Notes:
|
Current Offset Enabled
REG_SZ
False
True or False
Introduced as of version 5.2.b.20160922. When false, Domain Time will not update the current offset value in the registry
(Current Offset (signed 64-bit) described above) or fire the offset-changed event. Note, this reverses the behavior
introduced in version 5.2.b.20160415. To regain this behavior, set Current Offset Enabled to True, then trigger a sync or
issue dtcheck -reload. See the SDK.DOC file included with the Software Development Kit (SDK) for details.
|
Value Name: Value Type: Default Data: Notes:
|
Current PortState
REG_SZ
N/A
Introduced as of version 5.2.b.20160415. Read-only key for use with the Software Development Kit (SDK), purchased separately.
|
Value Name: Value Type: Default Data: Options: Notes:
|
Duplicate Node Detection Enabled
REG_SZ
True
True or False
Introduced as of version 5.2.b.20160415. Controls whether Domain Time will detect and prevent duplicate Clock Indentities
on the network.
|
Value Name: Value Type: Default Data: Options: Notes:
|
TAI-UTC Offset Discovered (seconds)
REG_DWORD
N/A
N/A
Contains the current TAI-UTC offset (number of UTC leap seconds) discovered from the upstream Master or by importing a leapfile using
the DTCheck utility. If this machine is acting as a stand-alone PTP Master, you may manually enter the number of leap seconds
(create the key if it doesn't exist). The service must be stopped/restarted for changes to this value to take effect.
|
Value Name: Value Type: Default Data: Options: Notes:
|
TAI-UTC Offset Locked
REG_SZ
False
True or False
Introduced as of version 5.2.b.20160922. If changed to True, DT will not adjust its discovered TAI-UTC offset to match
a new master advertising a different offset. The service must be stopped/restarted for this change to take effect.
You should use this setting only if you have a broken PTP master advertising an incorrect TAI-UTC offset.
|
|
Back to the System Tray Applet page
|
|
Domain Time II Software distributed by Microsemi, Inc.
Documentation copyright © 1995-2024 Greyware Automation Products, Inc.
All Rights Reserved
All Trademarks mentioned are the properties of their respective owners.
|