cvs commit: jakarta-tomcat-connectors/jk/native2/server/dsapi BUILD.txt
andya 2004/03/26 06:25:58
Modified:jk/native2/server/dsapi BUILD.txt
Log:
Added instructions for Linux
Revision ChangesPath
1.4 +105 -91 jakarta-tomcat-connectors/jk/native2/server/dsapi/BUILD.txt
Index: BUILD.txt
===
RCS file: /home/cvs/jakarta-tomcat-connectors/jk/native2/server/dsapi/BUILD.txt,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- BUILD.txt 18 Nov 2003 01:23:24 - 1.3
+++ BUILD.txt 26 Mar 2004 14:25:58 - 1.4
@@ -1,94 +1,108 @@
-$Id$
+Information on building mod_jk2:
-Building the Domino Redirector
---
+ Starting with 2.0.4, APR is mandatory for jk2. For Apache 2.0
+ or greater jk2 will use APR that was used to build Apache 2.0.
+ For Apache 1.3, jk2 must build APR and APR_UTIL from source.
+
+DSO build instructions for Unix-like systems:
+
+ The compiler used to build jk2 must match the one used to build
+ Apache. You may need to set an environment variable before
+ configuring such as CC=cc. `apxs -q CC` will tell you what
+ compiler was used for Apache.
+
+ The most straightforward way to configure jk2 is to use apxs
+ that comes with Apache. Linux distributions may need to have
+ additional rpm's installed such as Apache2 devel rpm,
+ httpd-devel or apache2-devel or for Apache 13, Apache devel
+ rpm, httpd-devel or apache-devel depending on your
+ distribution.
+
+ Example Apache2 build and install:
+
+cd jakarta-tomcat-connectors/jk/native2
+./configure --with-apxs2=/your/path/to/apxs
+make
+cd ../build/jk2/apache2
+apxs -n jk2 -i mod_jk2.so
+
+ Example Apache13 build and install:
+
+apr and apr-util will be configured and built for you while
+configuring and building jk2. There is no need to separately
+configure and build them.
+
+ cd jakarta-tomcat-connectors/jk/native2
+ ./configure --with-apxs=/your/path/to/apxs \
+ --with-apr=/absolute/path/to/apr-source \
+ --with-apr-util=/absolute/path/to/apr-util-source
+ make
+ cd ../build/jk2/apache13
+ apxs -n jk2 -i mod_jk2.so
+
+NOTE: pthread support may be automatically detected and built
+into apr. If apache13 was not built with pthread support, you
+can either disable it by adding --disable-apr-threads while
+configuring, or load the pthread library in httpd.conf using
+the LoadFile directive.
+
+ Optional configure arguments (for 1.3 and 2.0):
+
+If you want to have JNI support, add --with-jni and be sure
+to have the JAVA_HOME environment variable point to your Java
+Environment. This will build inprocess jni support into
+mod_jk2.so and additionally build libjkjni.so. libjkjni.so
+can be used by tomcat to provide support for channel unix and
+should be installed in the apache libexec dir. Use
+`apxs -q LIBEXECDIR` if you are unsure of its location.
+Libjkjni.so will be located in the same directory as
+mod_jk2.so after building with this option.
+
+If you want to have PCRE (Perl Compatible Regular
+Expressions) support for jk2 uri directives, add --with-pcre
+while configuring.
+
+
+Quick information on building mod_jk2 :
+
+* IIS
+
+There is a known issue with the latest APR 1.0 and MSVC6.
+If you want to use MSVC6, please use APR 0.9.x for now.
+MSVC7 doesn't have this issue, and could be used with APR 1.0.
+
+Isapi redirector requires the following libraries to build:
+apr, apr-util, apr-iconv and pcre.
+The easiest way to obtain all those libraries is to download
+the httpd-2.0.49-win32-src.zip from http://www.apache.org/dist/httpd or
+from any of the mirror sites.
+You will only need the srclib part (apr, apr-util, apr-iconv and pcre)
+Unzip the entire srclib folder to j-t-c native2 folder.
+Now open the isapi.dsw from MSVC6 and build.
+
+Building using VS.NET:
+Make sure that the required libraries are inside native2/srclib.
+Open the idapi.dsw and select 'Yes to all' when prompted to convert the project.
+During conversion the custom build adds extra quotations for
+jk_logger_win32_message.mc. Right click on that file and select Properties.
+For Custom Build Step remove all the quotations around ${InputDir}
+and ${InputPath}.
+
+
+
+* Netware
+
+Buid the JK2 connector for NetWare platform.
+
+The current NWNGUmakefile uses the same build system as Apache2 self for NetWare
target.
+Simply extract the downloaded archive, and follow the guideline which describes
compilation of Apache2 self.
+
+After you have compiled Apache2 (this is mandatory for now since the prebuild
process must have finished)
+you can simply call the makefile with 'make -f
cvs commit: jakarta-tomcat-connectors/jk/native2/server/dsapi BUILD.txt INSTALL.txt
andya 2003/11/17 17:19:24 Modified:jk/native2/server/dsapi BUILD.txt INSTALL.txt Log: Added information about mailing lists. Revision ChangesPath 1.2 +28 -1 jakarta-tomcat-connectors/jk/native2/server/dsapi/BUILD.txt Index: BUILD.txt === RCS file: /home/cvs/jakarta-tomcat-connectors/jk/native2/server/dsapi/BUILD.txt,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- BUILD.txt 14 Nov 2003 13:08:05 - 1.1 +++ BUILD.txt 18 Nov 2003 01:19:24 - 1.2 @@ -62,6 +62,33 @@ configuration 'Release Static' which will build a standalone dsapi_redirector2.dll. +Mailing Lists +- + +There are two mailing lists dedicated to the Domino Tomcat redirector: + +domino-tomcat-l: + http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-l + +domino-tomcat-l is a general discussion list for issues with the +redirector and also wider Tomcat/Domino integration issues such as +calling the Domino Java API from a Tomcat servlet. I expect it to be +fairly low volume so please subscribe if you're actively using the +redirector. If you have an issue with the redirector please post it to +the list where it will be seen not only by me but by other users who may +be able to help with any problems. + +domino-tomcat-announce-l: + http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-announce-l: + +domino-tomcat-announce-l is for announcements about the Domino Tomcat +redirector. Mainly this list will be used for new releases but serious +bugs will also be posted to it. This list will be very low volume; only +I can post to it. I wouldn't expect more than a few posts per month. For +this reason if you'd like to keep track of new redirector versions +please subscribe to this list. Once this mail is sent d-t-a-l will be +the main place to find out about new versions. + Please let me know if you have any problems. Andy Armstrong, [EMAIL PROTECTED] 1.2 +28 -1 jakarta-tomcat-connectors/jk/native2/server/dsapi/INSTALL.txt Index: INSTALL.txt === RCS file: /home/cvs/jakarta-tomcat-connectors/jk/native2/server/dsapi/INSTALL.txt,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- INSTALL.txt 14 Nov 2003 13:08:05 - 1.1 +++ INSTALL.txt 18 Nov 2003 01:19:24 - 1.2 @@ -93,6 +93,33 @@ may be available, depending on how Tomcat is configured. If that all works you're done ;-) +Mailing Lists +- + +There are two mailing lists dedicated to the Domino Tomcat redirector: + +domino-tomcat-l: + http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-l + +domino-tomcat-l is a general discussion list for issues with the +redirector and also wider Tomcat/Domino integration issues such as +calling the Domino Java API from a Tomcat servlet. I expect it to be +fairly low volume so please subscribe if you're actively using the +redirector. If you have an issue with the redirector please post it to +the list where it will be seen not only by me but by other users who may +be able to help with any problems. + +domino-tomcat-announce-l: + http://nomen.tagish.co.uk/mailman/listinfo/domino-tomcat-announce-l: + +domino-tomcat-announce-l is for announcements about the Domino Tomcat +redirector. Mainly this list will be used for new releases but serious +bugs will also be posted to it. This list will be very low volume; only +I can post to it. I wouldn't expect more than a few posts per month. For +this reason if you'd like to keep track of new redirector versions +please subscribe to this list. Once this mail is sent d-t-a-l will be +the main place to find out about new versions. + Please let me know if you have any problems. Andy Armstrong, [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-connectors/jk/native2/server/dsapi BUILD.txt INSTALL.txt
andya 2003/11/17 17:23:24 Modified:jk/native2/server/dsapi BUILD.txt INSTALL.txt Log: Small rewording of mailing list information Revision ChangesPath 1.3 +3 -3 jakarta-tomcat-connectors/jk/native2/server/dsapi/BUILD.txt Index: BUILD.txt === RCS file: /home/cvs/jakarta-tomcat-connectors/jk/native2/server/dsapi/BUILD.txt,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- BUILD.txt 18 Nov 2003 01:19:24 - 1.2 +++ BUILD.txt 18 Nov 2003 01:23:24 - 1.3 @@ -86,8 +86,8 @@ bugs will also be posted to it. This list will be very low volume; only I can post to it. I wouldn't expect more than a few posts per month. For this reason if you'd like to keep track of new redirector versions -please subscribe to this list. Once this mail is sent d-t-a-l will be -the main place to find out about new versions. +please subscribe to this list. From now on this list will be the main +place to find out about new versions. Please let me know if you have any problems. 1.3 +3 -3 jakarta-tomcat-connectors/jk/native2/server/dsapi/INSTALL.txt Index: INSTALL.txt === RCS file: /home/cvs/jakarta-tomcat-connectors/jk/native2/server/dsapi/INSTALL.txt,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- INSTALL.txt 18 Nov 2003 01:19:24 - 1.2 +++ INSTALL.txt 18 Nov 2003 01:23:24 - 1.3 @@ -117,8 +117,8 @@ bugs will also be posted to it. This list will be very low volume; only I can post to it. I wouldn't expect more than a few posts per month. For this reason if you'd like to keep track of new redirector versions -please subscribe to this list. Once this mail is sent d-t-a-l will be -the main place to find out about new versions. +please subscribe to this list. From now on this list will be the main +place to find out about new versions. Please let me know if you have any problems. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
