larryi 01/02/08 18:24:30
Modified: src/doc NT-Service-howto.html
Log:
Port 3.2 changes. Other miscellaneous updates.
Revision Changes Path
1.3 +25 -16 jakarta-tomcat/src/doc/NT-Service-howto.html
Index: NT-Service-howto.html
===================================================================
RCS file: /home/cvs/jakarta-tomcat/src/doc/NT-Service-howto.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- NT-Service-howto.html 2000/05/03 13:38:18 1.2
+++ NT-Service-howto.html 2001/02/09 02:24:29 1.3
@@ -1,14 +1,10 @@
-
-<!--
-$Header: /home/cvs/jakarta-tomcat/src/doc/NT-Service-howto.html,v 1.2 2000/05/03
13:38:18 shachor Exp $
-$Revision: 1.2 $
-$Date: 2000/05/03 13:38:18 $
---!>
-
<html>
<head>
-<meta http-equiv=Content-Type content="text/html">
-<title>Working with the Jakarta NT Service</title>
+ <!-- $Id: NT-Service-howto.html,v 1.3 2001/02/09 02:24:29 larryi Exp $ -->
+ <!-- Copyright 1999-2001, Apache Software Foundation -->
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+ <link rel="stylesheet" href="style.css">
+ <title>Working with the Jakarta NT Service</title>
</head>
<body>
@@ -29,18 +25,17 @@
hold on the NT executable (jk_nt_service.exe)</li>
<ul>
<li>Download
- the executable from <a
-
href="http://jakarta.apache.org/cvsweb/index.cgi/~checkout~/jakarta-tomcat/bin/nt_service/jk_nt_service.exe?rev=1.1">http://jakarta.apache.org/cvsweb/index.cgi/~checkout~/jakarta-tomcat/bin/nt_service/jk_nt_service.exe?rev=1.1</a>
- and save it under the name jk_nt_service.exe.</li>
+ the executable from the win32/i386 directory found where you downloaded the
+ <a href="http://jakarta.apache.org/downloads/binindex.html"> Tomcat binary
+ distribution.</a> For those using Netscape as your browser, try downloading
+ a zip version of the file, if available. There can be problems using Netscape
+ to download DLL files.</li>
</ul>
<li>Customize
a properties file that provides the service with Tomcat information
(wrapper.properties).</li>
<ul>
- <li>Download
- a template from <a
-
href="http://jakarta.apache.org/cvsweb/index.cgi/~checkout~/jakarta-tomcat/src/etc/wrapper.properties?rev=1.1">http://jakarta.apache.org/cvsweb/index.cgi/~checkout~/jakarta-tomcat/src/etc/wrapper.properties?rev=1.1</a>
- and save it under the name wrapper.properties.</li>
+ <li>Locate the wrapper.properties template file in your Tomcat conf/jk directory.
<li>Update
the wrapper.tomcat_home property to point at your tomcat home.</li>
<li>Update
@@ -70,6 +65,9 @@
<li>From
the NT services applet, highlight your service and press start.</li>
</ul>
+ <b>Note:</b> If the log file location in your wrapper.properties file points to
+ the <tt>logs</tt> directory, and the <tt>logs</tt> directory doesn't yet exist,
+ manually create it before starting the service.
<li>Stop
Tomcat as a service.</li>
<ul>
@@ -86,6 +84,17 @@
defined in your server.xml. In the absence of a configured AJPV12 port the
Tomcat service will kill Tomcat abruptly (that is murder it) without giving it
a chance to clean up. </p>
+
+<p><strong>Notice for JDK 1.3 users</strong>: There is a
+<a href="http://developer.java.sun.com/developer/bugParade/bugs/4323062.html">known
problem</a>
+in JDK 1.3 that affects Java applications being run as Windows NT services. The bug
causes the
+service to terminate when the currently logged in user logs out. The simplest way
to work
+around this problem is to use JDK 1.2. If your application requires JDK 1.3
features then you
+may want to look into <a href="http://www.kcmultimedia.com/javaserv/">javaserv</a>
or
+<a href="http://www.alexandriasc.com/software/JavaService/">JavaService</a>. Users
have reported
+success with both of these packages but there may be others that work as well.
+</p>
+<p>To remove the installed service, execute jk_nt_service -R <name of
service></p>
<h1>Advance Setup</h1>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]