If I get this wrong, then I fully expect people to point out my
mistakes. Not sure whether you guys prefer multiple tiny email or ones
like this.... In any case, attached are a number of diffs that I've
made against the latest CVS version of jakarta-tomcat-connectors in a
bid to try and improve the documentation.
If someone lets me know where the files created by the build process
(both java and native) need to go for jk2 I'll happily knock up an
install and install-native target.... I suspect
${catalina.home}/server/lib for most of them, but what about jkjni.so?
Regards,
Simon
--
Beware of programmers carrying screwdrivers!
--- - Thu Jul 4 02:09:10 2002
+++ jakarta-tomcat-connectors/coyote/README.txt Wed Jul 3 23:05:31 2002
@@ -0,0 +1,15 @@
+Building
+========
+
+* Install tomcat(3.3, 4.0, 4.1).
+
+* Ensure that the tomcat-coyote.jar has been built in the coyote directory.
+If you are currently in the jk directory, this is normally found in
+../coyote/build/lib.
+
+* Copy build.properties.sample to build.properties
+
+* Edit build.properties to taste. In particular it's important to set
+the paths to tomcat, catalina and apache.
+
+* Run "ant". It'll build modules for all the detected containers.
--- jakarta-tomcat-connectors.orig/jk/README.txt Thu Dec 20 00:15:43 2001
+++ jakarta-tomcat-connectors/jk/README.txt Thu Jul 4 01:27:35 2002
@@ -7,12 +7,23 @@
* Install tomcat(3.3, 4.0, 4.1). Install Apache(1.3, 2.0). Any
combination is fine, but j-t-c developers should have them all.
+* Make sure that tomcat-util.jar has been built. This is done by going
+ to the "../util" directory and following the build instructions
+ there.
+
+* Ensure that the tomcat-coyote.jar has been built in the coyote
+ directory. If you are currently in the jk directory, this is
+ normally found in ../coyote/build/lib.
+
* Copy build.properties.sample to build.properties
* Edit build.properties to taste. In particular it's important to set
-the paths to tomcat and apache.
+ the paths to tomcat, catalina and apache.
-* Run "ant". It'll build modules for all the detected containers.
+* Run "ant". It'll build modules for all the detected containers. Any
+ errors about not being able to resolve symbols indicate either that
+ the coytote or util jars have not been built, or that the catalina
+ path has not been set properly.
* If your system have a current working version of libtool, run "ant native".
This will build the native connectors for the detected servers ( both jk
@@ -24,6 +35,10 @@
in your server/container. Optional: on unix systems you can create
symlinks ( XXX script will be provided ) and avoid copying.
+* Finally, you are strongly advised to compile the documentation for
+ this module. Do this by running "ant docs" This builds the
+ documentation in "build/docs/"
+
Setting tomcat 3.3
==================
@@ -57,6 +72,10 @@
Configuring JK2
===============
+Configuring the native side depends on which server you are using (XXX
+should indicate which docs to read) The java side of the connector is
+configured using the jk2.properties file. This is documented properly
+in the docs that can be compiled using ant
Building the tests
==================
@@ -65,4 +84,4 @@
* Download junit from http://www.junit.org (version 3.7 or greater is required).
-* "ant test"
\ No newline at end of file
+* "ant test"
--- jakarta-tomcat-connectors.orig/jk/xdocs/configweb.xml Tue Jul 2 00:42:24
2002
+++ jakarta-tomcat-connectors/jk/xdocs/configweb.xml Thu Jul 4 01:43:48 2002
@@ -17,7 +17,40 @@
</section>
<section name="Installation">
<subsection name="Apache 1"/>
- <subsection name="Apache 2"/>
+ <subsection name="Apache 2">
+ <p>
+ These instructions cover just the native jk2 connector. For more
+ complete instructions read the README.txt file in the jk
+ directory of the jakarta-tomcat-connectors project.
+ </p>
+
+ <p>Install tomcat(3.3, 4.0, 4.1). Install Apache 2.0. Any
+ combination is fine, but j-t-c developers should have them
+ all.</p>
+
+ <p>Copy "build.properties.sample" to
+ "build.properties" Edit to taste, in particular
+ being sure to set the paths to tomcat, catalina and apache.</p>
+
+ <p>If your system has a current working version of libtool, run
+ "ant native" This will build the native connectors
+ for the detected servers (both jk and jk2).</p>
+
+ <p>Copy "build/jk2/apache2/mod_jk2.so" to the Apache installation's
+ modules directory.</p>
+
+ <p>Edit httpd.conf to include the line:
+ <source>
+ LoadModule jk2_module modules/mod_jk2.so
+ </source>
+ </p>
+
+ <p>Create and edit workers2.properties file as detailed below</p>
+
+ <p>Running <code>apachectl configtest</code> now should return
+ with no errors.</p>
+
+ </subsection>
<subsection name="IIS"/>
</section>
<section name="Config file">
--- - Thu Jul 4 02:08:11 2002
+++ jakarta-tomcat-connectors/README.txt Thu Jul 4 01:49:22 2002
@@ -0,0 +1,7 @@
+A note on module dependencies.
+
+mod_jk(1 and 2) found in the jk directory depends on the following modules
+being built in the following order before being compiled itself:
+
+util
+coyote
--- jakarta-tomcat-connectors.orig/util/README.txt Tue May 29 06:40:47 2001
+++ jakarta-tomcat-connectors/util/README.txt Wed Jul 3 22:17:55 2002
@@ -5,4 +5,5 @@
in something like jakarta-tomcat-util, or something.... [seguin].
To build, simply run ant. The default target creates tomcat-util.jar
-int ./build/lib.
+int ./build/lib. You will not need to copy or edit the
+build.properties.sample file
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
