Tardis 2000 v1 6 Manual

Tardis 2000 v1 6 Manual Tardis 2000 v1.6 December 2004 Tardis 2000 Time Synchronisation page 2 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 1 Contents 1 CONTENTS 2 2 SHAREWARE 4 3 WELCOME TO TARDIS 2000 5 4 INSTALLATION 6 4.1 TARDIS 2000 6 4.2 APPLICATION OR SERVICE 6 4.3 INSTALL COMMAND LINE OPTIONS 6 4.4 MANUAL INSTALLATION 7 4.5 RUNNING TARDIS 2000 SERVICE IN DEBUG MODE 8 4.6 COEXISTENCE OF TARDIS 2000 SERVICE WITH WINDOWS TIME SERVICE 8 4.7 LOGGING 9 4.8 TARDIS 2000 AND WINDOWS XP SP2 FIREWALL 9 5 EXAMPLES OF USING TARDIS 2000 12 5.1 A STAND-ALONE PC USING A DIAL-UP CONNECTION TO THE INTERNET 12 5.2 A PC ON A LAN ACCESSING INTERNET SERVICES 12 5.3 A PC ON A LAN USING LOCAL TIME SERVERS 12 5.4 A PC WITH A GPS OR RADIO DEVICE 12 5.5 TARDIS 2000 ACTING AS A TIME SERVER 12 6 CONFIGURING TARDIS 13 6.1 MAIN SCREEN 13 7 OPTIONS PAGES 16 7.1 SETTING THE TIME 16 7.2 DIALUP 18 7.3 GENERAL OPTIONS 19 7.4 INFORMATION PAGE 20 7.5 GPS 22 7.6 BROADCAST NTP/NTP 23 7.7 HTTP PROXY SETTINGS 25 7.8 ALERTS 25 8 TIME SERVERS 27 9 TECHNICAL SUPPORT FOR TARDIS 2000 28 10 REGISTERING AND PAYING FOR TARDIS 2000 29 10.1 PAYMENTS 29 10.2 UPGRADE POLICY 29 11 FREQUENTLY ASKED QUESTIONS 34 12 TIME PROTOCOLS 40 Tardis 2000 Time Synchronisation page 3 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 12.1 NTP BROADCAST PROTOCOL 40 12.2 NMEA 40 12.3 HTTP PROTOCOL 40 12.4 GALLEON RADIO CLOCK 41 12.5 KALLISTO GPS CARD 42 12.6 RFC2030 SNTP 44 12.7 RFC867 DAYTIME 57 12.8 RFC868 TIME 58 12.9 RFC792 ICMP TIMESTAMP SECTION 59 12.10 OTHER RADIO AND GPS CLOCKS SUPPORTED. 62 13 K9 63 13.1 FREQUENTLY ASKED QUESTIONS ABOUT K9 63 Tardis 2000 Time Synchronisation page 4 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 2 Shareware Copyright Notice 1994-2005 H.C. Mingham-Smith Ltd. quotThe authorquot THE SOFTWARE IS PROVIDED quotAS-ISquot AND WITHOUT WARRANTY OF ANY KIND EXPRESS IMPLIED OR OTHERWISE INCLUDING WITHOUT LIMITATION ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL INCIDENTAL INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE DATA OR PROFITS WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE AND ON ANY THEORY OF LIABILITY ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Tardis 2000 is Shareware. This is a complete working version. There are no annoying reminder screens about what it costs and there are no disabled features. If you continue to use it after evaluating it please send payment as detailed on page 29. Tardis 2000 Time Synchronisation page 5 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 3 Welcome to Tardis 2000 Tardis 2000 is a utility for Windows that makes sure your PC?s clock tells the right time. It can find out what the right time is in various ways including using networked timeservers GPS The Global Positioning System Radio clocks and by listening for time broadcasts over a LAN. Tardis 2000 requires the TCP/IP networking protocol to be installed. The service version of Tardis 2000 runs as a Windows “service” just like other services that come as standard with Windows. It acts as both a server and client for the supported protocols. I.e. it can get the time from a timeserver with the „correct? time and then make the „correct? time available to local clients. Tardis 2000 running on a central server can be used as a master time source for the domain by running Tardis or K9 on the other workstations of the domain using the server machine as the timeserver. See page 63 for details of K9. Tardis 2000 can use the following time protocols ?? RFC868 Time ?? RFC867 Daytime ?? RFC2030 SNTP ?? Broadcast NTP ?? HTTP protocol. ?? Kallisto GPS. ?? NMEA compliant GPS cards. ?? Galleon Radio Clock ?? ICMP timestamp ?? Trimble Palisade ?? EndRun Technologies Pr??cis Ct ?? Kinemetrics Truetime ?? Spectracom WWVB ?? NeoClock ?? Expert mouseCLOCK ?? Serial Radio Clock connected to DCD pin ?? EMC Professional in XNTP mode ?? IRIG-B Thanks We would like to thank Mark Symons who helped enormously in the development of Tardis 2000. Tardis 2000 Time Synchronisation page 6 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 4 Installation 4.1 Tardis 2000 Tardis 2000 is distributed as a setup file called tardis2000.exe. This manual and the installable Tardis 2000 files are contained within it. Run the tardis2000.exe program and Tardis 2000 will automatically be installed. 4.2 Application or Service If your PC runs Windows 95/98/ME you will only be given the option to install the Application version of Tardis. If you use more recent versions of Windows you have the option of using either the application version or the service version. We recommend that you use the service version. Both versions have essentially the same functionality. The difference is that the application is a stand-alone utility the service version is a control panel and a background service that runs all the time whether anyone is logged in or not. You should log into your Windows NT/2000/XP/2003 system as a user with administrative privileges. Tardis 2000 must be installed and configured by someone with administrative privileges. 4.3 Install command line options Tardis 2000 now uses the wonderful Inno Setup cancelling during the installation process by disabling the Cancel button and ignoring clicks on the close button. Useful along with /SILENT or /VERYSILENT. /NORESTART Instructs Setup not to reboot even if its necessary. /RESTARTEXITCODEexit code Specifies the custom exit code that Setup is to return when a restart is needed. Useful along with /NORESTART. Also see Setup Exit Codes. /LOADINFquotfilenamequot Instructs Setup to load the settings from the specified file after having checked the command line. This file can be prepared using the /SAVEINF command as explained below. Dont forget to use quotes if the filename contains spaces. /SAVEINFquotfilenamequot Instructs Setup to save installation settings to the specified file. Dont forget to use quotes if the filename contains spaces. /DIRquotx:dirnamequot Overrides the default directory name displayed on the Select Destination Location wizard page. A fully qualified pathname must be specified. /GROUPquotfolder namequot Overrides the default folder name displayed on the Select Start Menu Folder wizard page. /NOICONS Instructs Setup to initially check the Dont create any icons check box on the Select Start Menu Folder wizard page. /COMPONENTSquotcomma separated list of component namesquot Overrides the default components settings. Using this command line parameter causes Setup to automatically select a custom type. 4.4 Manual Installation Occasionally the installation of the Tardis 2000 Service must be done manually usually where other software interferes with the automatic installation process. The Tardis 2000 Service files can be requested by E-mail and installed manually as follows. Log into your Windows NT/2000/XP/2003 system as a user with administrative privileges. Decide which directory you are going to put the tardisNT.exe in and move it there. A good choice is the WINNTSYSTEM32 directory which is where many other services live. Using the Security/Permissions menu option in the File Manager ensure that the SYSTEM user has read permission for the file. Install tardisNT.exe as a service by running the program from the Windows NT/2000/XP/2003 command line specifying the add flag. NOTE - it is vital that you execute this command specifying the copy of tardisNT.EXE which you placed in the WINNTSYSTEM32 directory and not using some other copy which you plan subsequently to delete. For instance: tardisNT add The program will register itself and its location with the Service Manager and will report success or failure. In the case of failure see the section on Installation Problems below. To verify that the installation has succeeded start the Windows NT/2000/XP/2003 Control Panel and double-click on the Services icon. The resulting dialog should list Tardis as one of the installed services. 4.4.1 Installation Problems Message Meaning The system says that tardisNT.EXE is not a This is probably because you are trying to run an Tardis 2000 Time Synchronisation page 8 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 Windows NT/2000/XP/2003 program executable for the wrong sort of processor or the file is damaged. This function is only valid in Win32 mode. 0x78 You aren?t running Windows NT/2000/XP/2003 “Failed to create service.” This error message occurs if you try to install tardisNT when it is already installed. Could not start tardisNT time synchronization service on yourmachine.Error 0002: The system cannot find the file specified. The Service Manager could not locate tardisNT.EXE. This probably means it has been moved or has not been installed correctly. Remove and reinstall tardisNT - see section above for details. Could not start tardisNT time synchronization service on yourmachine.Error 0005: Access is denied. tardisNT.EXE is inaccessible to the SYSTEM user. By default the Service Manager starts the tardisNT process running under a user ID of SYSTEM. The executable file for the service must be readable by this user. 4.4.2 Manual Deinstallation This section describes what to do if you want to remove the Tardis 2000 Service from your computer. At the Windows NT/2000/XP/2003 command line run tardisNT with the cleanup option: tardisNT cleanup This will remove the service and the control panel after a reboot. 4.5 Running Tardis 2000 Service in debug mode To make debugging easier you can run Tardis in debug mode like so. TARDISNT debug This should run Tardis as a console application. Log information and debugging are shown on the screen. Make sure that the service isn?t running when you run tardisnt in debug mode otherwise you will be running it twice. 4.6 Coexistence of Tardis 2000 service with Windows Time Service Windows 2000 XP and more recent versions have a primitive Time Service installed by default. The Tardis 2000 Service and the Windows Time Service require some help to coexist on the same PC because they both try to use the same NTP network port. Tardis 2000 allocates the port and the Windows Time Service complains and is generally unhappy. When the control panel is started Tardis 2000 will warn you when the Windows Time Service is active. Tardis 2000 Time Synchronisation page 9 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 You have the option to stop the Windows Time Service removing the problem. If this option is selected the Windows Time Service will be stopped and disabled. Note: This may not be possible if other services depend on the Windows Time Service as may be the case on primary domain controllers. The best workaround is to make the Tardis 2000 service depend on the Windows Time Service so it starts second. Tardis 2000 will work around port 123 being unavailable and everything should be ok. Tardis 2000 may not be able to act as an NTP server if this option is selected. On Windows XP Service Pack 2 the new firewall blocks NTP requests from reaching Tardis 2000. Select the option to allow NTP or open the port manually as shown here. 4.7 Logging If an error in the operation of the service occurs the error will be logged in the Application Event Log. This log may be viewed with the Event Viewer which you will find in the Administrative Tools program group. See your Windows NT/2000/XP/2003 documentation for details of how to use the Event Viewer. The events logged in the Application Event Log can be associated with a Tardis problem e.g. a file I/O error or a system call failure caused by lack of resources or a problem with the configuration information. Problems associated with the network are recorded in the Application Event Log as Warning events. Tardis also logs information such as Time updates and service starts and stops. Further information on events that may be logged by Tardis is given in the chapter on troubleshooting on page 20 of this manual. Note that the Event Viewer uses the TARDIS.CPL file to interpret messages associated with events. Therefore if you delete the TARDIS.CPL file Tardis events in your Application Event Log will be unintelligible. 4.8 Tardis 2000 and Windows XP SP2 firewall Service Pack 2 for windows XP contains a new firewall feature that may interfere with the normal operation of Time synchronization products. This describes how to configure the firewall to allow unsolicited NTP messages through to K9 and Tardis. Open the firewall control panel. Make sure the settings are set like this Tardis 2000 Time Synchronisation page 10 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 On the Exception tab click on Add Port Tardis 2000 Time Synchronisation page 11 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 Then add a setting to allow NTP. Press OK and everything should work like it did before SP2 improved things. Tardis 2000 Time Synchronisation page 12 Copyright ?? H.C. Mingham-Smith Ltd. 1994-2005 5 Examples of using Tardis 2000 5.1 A Stand-alone PC Using a Dial-Up Connection to the Internet Many users configure Tardis to reset their PC?s clock each time they log on to the Internet using a dial-up connection. Tardis should be running before the dial-up connection is established and configured to access a time server once you are logged on to the Internet. Simply select “Options” click on the dial-up tab then click on “Watch for dial-up”. When Tardis 2000 detects an active RAS connection it uses it to access a time server and sets the time otherwise it will sit there waiting. If the option is not set Tardis may cause a dialup connection to be started depending on your dialup networking settings. Tardis knows nothing about this and will assume that you are on a LAN Tardis will not shutdown any connection automatically started in this way. Tardis 2000 incorporates a default set of Time Servers. It will always access the one at the top of the list so if you wish to obtain the time from a particular server move it to the top of the list by right clicking on it and selecting “move to top”. 5.2 A PC on a LAN Accessing Internet Services For LANs connected directly to the Internet any PC on the LAN can run Tardis 2000 as outlined above. Alter.