source: trunk/third/xntp/WINNT-README.html @ 10832

Revision 10832, 9.1 KB checked in by brlewis, 27 years ago (diff)
This commit was generated by cvs2svn to compensate for changes in r10831, which included commits to RCS files with non-trunk default branches.
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Draft//EN">
2<HTML>
3
4<HEAD>
5
6<TITLE>----------------------------------------------------------------------------
7</TITLE>
8
9<META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.0z">
10</HEAD>
11
12<BODY>
13
14<P>
15<CENTER><FONT SIZE=2>----------------------------------------------------------------------------</FONT></CENTER>
16<P>
17<CENTER><B><FONT SIZE=5>XNTP Release for Windows NT</FONT></B></CENTER>
18<P>
19<CENTER><FONT SIZE=2>----------------------------------------------------------------------------
20<BR>
21</FONT></CENTER>
22<P>
23<FONT SIZE=2>This is an unsupported release, for assistance from
24other users, post to the UseNet newsgroup: <I>comp.protocols.time.ntp</I></FONT>
25<P>
26<FONT SIZE=2>There will eventually be documentation with this
27release, in the file NTPOG.WRI. It is Windows Write format. <BR>
28</FONT>
29<P>
30<FONT SIZE=2>To update to a newer version, run the setup program
31again.<BR>
32<BR>
33</FONT>
34<P>
35<U><FONT SIZE=5>Building XNTP for Windows NT<BR>
36</FONT></U>
37<P>
38<FONT SIZE=2>Requirements:</FONT>
39<UL>
40<LI><FONT SIZE=2>Latest InstallShield SDK for Windows NT 4.0 support</FONT>
41<LI><FONT SIZE=2>Perl5 for Win32 from http://www.perl.hip.com
42or your favorite place</FONT> <BR>
43
44</UL>
45
46<P>
47
48<P>
49<FONT SIZE=2>First off there are two options for installing. </FONT>
50<UL>
51<LI><FONT SIZE=2>Graphical <B>InstallShield SDK</B> based installation
52process (needs to be updated to reflect the new directory structure)</FONT>
53<LI><B><FONT SIZE=2>Batch file</FONT></B><FONT SIZE=2> for installing
54the executables (always works)</FONT> <BR>
55
56</UL>
57
58<P>
59
60<P>
61<FONT SIZE=2>The software is known to work on Windows NT 3.5,
623.51, and 4.0. However, the latest version of the InstallShield
63SDK must be installed in order to support a graphical install
64on Windows NT 4.0. <BR>
65</FONT>
66<P>
67<CENTER><FONT SIZE=5>Windows 95 is not supported.<BR>
68</FONT></CENTER>
69<P>
70<FONT SIZE=2>To compile the sofware you have two options</FONT>
71<OL>
72<LI><FONT SIZE=2>Debugging version</FONT> 
73</OL>
74
75<P>
76<FONT SIZE=2>Run <B>blddbg.bat<BR>
77</B></FONT>
78<OL>
79<LI><FONT SIZE=2>Nondebugging version</FONT> 
80</OL>
81
82<P>
83<FONT SIZE=2>Run <B>bldrel.bat<BR>
84</B></FONT>
85<P>
86<FONT SIZE=2>Either of these will compile the entire package,
87placing the executables into the <I>scripts\wininstall\distrib</I>
88directory. After which the graphical installer will be built.
89<BR>
90<BR>
91</FONT>
92<P>
93<U><FONT SIZE=5>Batch Install<BR>
94</FONT></U>
95<P>
96<I><FONT SIZE=2>scripts\wininstall\distrib\install.bat<BR>
97</FONT></I>
98<P>
99<FONT SIZE=2>NOTE: You will now have to modify the configuration
100files installed by the install.bat program and also the ntp.conf
101file (config file) installed in the WinNT home directory. <BR>
102</FONT>
103<P>
104<FONT SIZE=2>****YOU MUST ****** modify the directory line in
105the ntp.conf or ntp.ini</FONT>
106<P>
107<FONT SIZE=2>(it will accept either name)... and change the single
108slash to double slashes</FONT>
109<P>
110<FONT SIZE=2>ie. <B>c:\winnt\ntp.conf</B> becomes <B>c:\\winnt\\ntp.conf
111<BR>
112<BR>
113<BR>
114</B></FONT>
115<P>
116<U><FONT SIZE=5>Graphical Install<BR>
117<BR>
118</FONT></U>
119<P>
120<FONT SIZE=2>If you currently have XNTP on this machine (any older
121version that was NOT installed using this GUI) you must STOP NOW,
122and REMOVE IT from your system before running this install program.
123There is no way to easily do this automatically.<BR>
124</FONT>
125<P>
126<I><FONT SIZE=2>scripts\wininstall\intel\disk1\setup.exe<BR>
127<BR>
128</FONT></I>
129<P>
130<FONT SIZE=2>This installation program will create what it thinks
131are sensible defaults for the configuration files for XNTP. If
132you have a tricky setup, let it finish, then go back and stop
133the service (try the control panel applet) and edit the configuration
134files. The files will all be in the Windows System directory (default
135is %windir%\) and will be named as follows:</FONT>
136<P>
137<FONT SIZE=2>ntp.conf - the NTP configuration file.</FONT>
138<P>
139<FONT SIZE=2>ntp.drift - the NTP drift file<BR>
140<BR>
141</FONT>
142<P>
143<U><FONT SIZE=5>Other Batch Files</FONT></U>
144<UL>
145<LI><FONT SIZE=2>mkdist.bat - To package binaries for in a ZIP
146archive.</FONT>
147<LI><FONT SIZE=2>mksrc.bat - To package source, excluding files
148specified in the &quot;excludes&quot; file.</FONT>
149<LI><FONT SIZE=2>scripts/wininstall/build.bat - Creates GUI installer,
150must be modified to reflect InstallShield source directory.</FONT>
151<BR>
152
153</UL>
154
155<P>
156
157<P>
158<FONT SIZE=2>There are some important notes concerning the InstallShield
159SDK You must modify the build.bat file to change the InstallShield
160source directory, and you must modify the <I>setup.lst</I> to
161reflect the full pathnames based on where you are building the
162software.<BR>
163<BR>
164<BR>
165</FONT>
166<H2>ANNOUNCE: Enhancements to the Windows NT port of XNTP <BR>
167</H2>
168
169<P>
170<FONT SIZE=2>This set of changes fixes all known bugs, and it
171includes several major enhancements.</FONT>
172<P>
173<FONT SIZE=2>Many changes have been made both to the build environment
174as well as the code. There is no longer an ntp.mak file, instead
175there are two batch files bldrel.bat and blddbg.bat file that
176will build the entire source.</FONT>
177<P>
178<FONT SIZE=2>Perl5 for Win32 is required, but is easily available
179from the NT Resource Kit or from the Internet at <I>http://www.perl.hip.com</I>.</FONT>
180<P>
181<FONT SIZE=2>The multiple interface support was adapted from Larry
182Kahn's work on the BIND NT port. I have not been able to test
183it adequately as I only have NT servers with one network interfaces
184on which to test.</FONT>
185<P>
186<FONT SIZE=2>Enhancements:</FONT>
187<UL>
188<LI><FONT SIZE=2>Event Logging now works correctly.</FONT>
189<LI><FONT SIZE=2>Version numbers now work (requires Perl during
190build)</FONT>
191<LI><FONT SIZE=2>Support for multiple network interface cards
192(untested)</FONT>
193<LI><FONT SIZE=2>NTP.CONF now default, but supports ntp.ini if
194not found</FONT>
195<LI><FONT SIZE=2>Installation procedure automated.</FONT>
196<LI><FONT SIZE=2>All paths now allow environment variables such
197as %windir%</FONT>
198</UL>
199
200<P>
201<FONT SIZE=2>Bug fixes:</FONT>
202<UL>
203<LI><FONT SIZE=2>INSTSRV replaced, works correctly</FONT>
204<LI><FONT SIZE=2>Cleaned up many warnings</FONT>
205<LI><FONT SIZE=2>Corrected use of an uninitialized variable in
206XNTPD</FONT>
207<LI><FONT SIZE=2>Fixed ntpdate -b option</FONT>
208<LI><FONT SIZE=2>Fixed ntpdate to accept names as well as IP addresses</FONT>
209<LI><FONT SIZE=2>Fixed problem with &quot;longjmp&quot; in xntpdc/ntpdc.c
210that</FONT>
211</UL>
212
213<MENU>
214<LI><FONT SIZE=2>caused a software exception on doing a Control-C
215in xntpdc.</FONT>
216<LI><FONT SIZE=2>A Cntrl-C now terminates the program.</FONT>
217
218</MENU>
219
220<P>
221<FONT SIZE=2>See below for more detail:</FONT>
222<P>
223<FONT SIZE=2>Note: SIGINT is not supported for any Win32 application
224including Windows NT and Windows 95. When a CTRL+C interrupt occurs,
225Win32 operating systems generate a new thread to specifically
226handle that interrupt. This can cause a single-thread application
227such as UNIX, to become multithreaded, resulting in unexpected
228behavior.<BR>
229</FONT>
230<P>
231<FONT SIZE=2>Possible enhancements and things left to do:</FONT>
232<UL>
233<LI><FONT SIZE=2>Reference clock drivers for NT (at least Local
234Clock support)</FONT>
235<LI><FONT SIZE=2>Control Panel Applet</FONT>
236<LI><FONT SIZE=2>InstallShield based installation, like NT BIND
237has</FONT>
238<LI><FONT SIZE=2>Integration with NT Performance Monitor</FONT>
239<LI><FONT SIZE=2>SNMP integration</FONT>
240<LI><FONT SIZE=2>Fully test multiple interface support</FONT>
241<BR>
242
243</UL>
244
245<P>
246
247<P>
248<FONT SIZE=2>Known problems:</FONT>
249<UL>
250<LI><FONT SIZE=2>bug in ntptrace - if no Stratum 1 servers are
251available,</FONT>
252</UL>
253
254<MENU>
255<LI><FONT SIZE=2>such as on an IntraNet, the application crashes.</FONT>
256
257</MENU>
258
259<P>
260<FONT SIZE=2></FONT>
261<P>
262<FONT SIZE=2>Greg Schueman - schueman@acm.org<BR>
263<BR>
264</FONT>
265<P>
266<TT>------------------------------------------------------------------------</TT>
267<P>
268<TT>Disclaimer of Warranties. THE SOFTWARE AND ASSOCIATED DOCUMENTATION
269ARE PROVIDED &quot;AS IS&quot; WITHOUT WARRANTY OF ANY KIND, EITHER
270EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY WARRANTY
271OF MERCHANTABILITY, FITNESS FOR ANY PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
272THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE
273AND DOCUMENTATION IS WITH YOU. NO ONE WARRANTS THAT THE SOFTWARE
274WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION OF THE SOFTWARE
275WILL BE UNINTERRUPTED OR ERROR FREE, OR THAT DEFECTS IN THE SOFTWARE
276WILL BE CORRECTED.<BR>
277</TT>
278<P>
279<TT>PRODUCTION, OR DISTRIBUTION OF THE SOFTWARE BE LIABLE TO YOU
280ON ACCOUNT OF ANY CLAIM FOR ANY SPECIAL EXEMPLARY OR PUNITIVE
281DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS, BUSINESS INTERRUPTION,
282LOSS OF BUSINESS OR PERSONAL INFORMATION OR ANY OTHER INCIDENTAL
283OR  CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE, THE INABILITY
284TO USE, QUALITY, OR PERFORMANCE OF THE SOFTWARE AND DOCUMENTATION,
285EVEN IF SAID AUTHORS, HAVE BEEN ADVISED OF THE POSSIBILITY OF
286SUCH DAMAGES.</TT>
287<P>
288<TT>------------------------------------------------------------------------
289<BR>
290</TT>
291</BODY>
292
293</HTML>
Note: See TracBrowser for help on using the repository browser.