 Registry Settings
Domain Time II Client
Version 5.2 |
Domain Time Client keeps its settings in the Windows Registry. Most of the service options are best set using the Domain Time Client 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 Client.
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 Client settings are located in these keys
(click the names to jump to details):
HKEY_LOCAL_MACHINE
Software
Greyware
Domain Time Client
Enabled Protocols
Keyring
Logs and Alerts
Parameters
Time Sources
Enabled Protocols
The Domain Time II Client Enabled Protocols settings are located in this key:
HKEY_LOCAL_MACHINE
Software
Greyware
Domain Time Client
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
Status Reports and Advanced property pages
of the Control Panel applet. You should not make manual changes to this key or its subkeys.
|
Keyring
The Domain Time II Client Keyring settings are located in this key:
HKEY_LOCAL_MACHINE
Software
Greyware
Domain Time Client
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 Client Logs and Alerts settings are located in this key:
HKEY_LOCAL_MACHINE
Software
Greyware
Domain Time Client
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 Client Parameter settings are located in this key:
HKEY_LOCAL_MACHINE
Software
Greyware
Domain Time Client
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 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 Client and the clock changes unexpectedly, the
Client 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:
|
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:
|
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 Client,
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:
| Client 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 domtimec.log in the %SystemRoot%\System32\ folder. The complete path
and filename must be specified (i.e. C:\Windows\System32\domtimec.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 Client Time Sources settings are located in this key:
HKEY_LOCAL_MACHINE
Software
Greyware
Domain Time Client
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
|
