cvs commit: jakarta-tomcat-connectors/jk/xdocs/jk domhowto.xml neshowto.xml iishowto.xml
hgomez 2002/09/12 00:54:16 Modified:jk/xdocs/jk domhowto.xml neshowto.xml iishowto.xml Log: Correct english sentences Revision ChangesPath 1.4 +1 -1 jakarta-tomcat-connectors/jk/xdocs/jk/domhowto.xml Index: domhowto.xml === RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/jk/domhowto.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- domhowto.xml 10 Sep 2002 08:02:49 - 1.3 +++ domhowto.xml 12 Sep 2002 07:54:16 - 1.4 @@ -12,7 +12,7 @@ /p p -We recommand you to read also the a href=jk/workershowto.htmlWorkers HowTo/a document +It is recommanded that you also read the a href=jk/workershowto.htmlWorkers HowTo/a document to learn how to setup the working entities between your WebServer and Tomcat Engines. /p 1.4 +1 -1 jakarta-tomcat-connectors/jk/xdocs/jk/neshowto.xml Index: neshowto.xml === RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/jk/neshowto.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- neshowto.xml 10 Sep 2002 08:02:49 - 1.3 +++ neshowto.xml 12 Sep 2002 07:54:16 - 1.4 @@ -18,7 +18,7 @@ /p p -We recommand you to read also the a href=jk/workershowto.htmlWorkers HowTo/a document +It is recommanded that you also read the a href=jk/workershowto.htmlWorkers HowTo/a document to learn how to setup the working entities between your WebServer and Tomcat Engines. /p 1.4 +1 -1 jakarta-tomcat-connectors/jk/xdocs/jk/iishowto.xml Index: iishowto.xml === RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/jk/iishowto.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- iishowto.xml 10 Sep 2002 08:02:49 - 1.3 +++ iishowto.xml 12 Sep 2002 07:54:16 - 1.4 @@ -18,7 +18,7 @@ /p p -We recommand you to read also the a href=jk/workershowto.htmlWorkers HowTo/a document +It is recommanded that you also read the a href=jk/workershowto.htmlWorkers HowTo/a document to learn how to setup the working entities between your WebServer and Tomcat Engines. /p -- To unsubscribe, e-mail: mailto:[EMAIL PROTECTED] For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat-connectors/jk/xdocs/jk domhowto.xml neshowto.xml aphowto.xml iishowto.xml
hgomez 2002/09/09 02:57:10
Modified:jk/xdocs/jk domhowto.xml neshowto.xml aphowto.xml
iishowto.xml
Log:
Add references to WorkersHowTo, a must read ;)
Revision ChangesPath
1.2 +5 -0 jakarta-tomcat-connectors/jk/xdocs/jk/domhowto.xml
Index: domhowto.xml
===
RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/jk/domhowto.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- domhowto.xml 5 Sep 2002 12:51:26 - 1.1
+++ domhowto.xml 9 Sep 2002 09:57:10 - 1.2
@@ -12,6 +12,11 @@
/p
p
+We recommand you to read also the a href=jk/workershowto.htmlWorkers HowTo/a
document
+to learn how to setup the working entities between your WebServer and Tomcat
Engines.
+/p
+
+p
Recent version of the Lotus Domino web server have had the ability to host Java
servlets,
but at the time of writing the Domino servlet container uses JDK 1.2.2 and it is
not (apparently)
possible to replace this with JDK 1.3.
1.2 +7 -0 jakarta-tomcat-connectors/jk/xdocs/jk/neshowto.xml
Index: neshowto.xml
===
RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/jk/neshowto.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- neshowto.xml 5 Sep 2002 08:38:50 - 1.1
+++ neshowto.xml 9 Sep 2002 09:57:10 - 1.2
@@ -10,11 +10,18 @@
p
This document explains how to set up Netscape web servers to cooperate with Tomcat.
/p
+
p
Normally the Netscape web servers come with their own Servlet engine,
but you can also configure them to send servlet and JSP requests to Tomcat
using the Tomcat redirector plugin.
/p
+
+p
+We recommand you to read also the a href=jk/workershowto.htmlWorkers HowTo/a
document
+to learn how to setup the working entities between your WebServer and Tomcat
Engines.
+/p
+
subsection name=Document Conventions and Assumptions
p
1.4 +8 -2 jakarta-tomcat-connectors/jk/xdocs/jk/aphowto.xml
Index: aphowto.xml
===
RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/jk/aphowto.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- aphowto.xml 9 Sep 2002 09:15:36 - 1.3
+++ aphowto.xml 9 Sep 2002 09:57:10 - 1.4
@@ -10,8 +10,14 @@
p
This document explains how to connect Tomcat to the popular open source web server,
Apache.
There is actually to version of Apache, 1.3 and 2.0 and both could used mod_jk, the
Tomcat redirector
-module
+module.
/p
+
+p
+We recommand you to read also the a href=jk/workershowto.htmlWorkers HowTo/a
document
+to learn how to setup the working entities between your WebServer and Tomcat
Engines.
+/p
+
p
This document was originally part of bTomcat: A Minimalistic User's Guide/b
written by Gal Shachor,
but has been split off for organizational reasons.
@@ -36,7 +42,7 @@
/p
p
In all the examples in this document ${tomcat_home} will be b/var/tomcat3/b.
-A worker is defined to be a tomcat process that accepts work from the IIS server.
+A a href=jk/workershowto.htmlworker/a is defined to be a tomcat process that
accepts work from the IIS server.
/p
/subsection
1.2 +7 -0 jakarta-tomcat-connectors/jk/xdocs/jk/iishowto.xml
Index: iishowto.xml
===
RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/jk/iishowto.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- iishowto.xml 5 Sep 2002 08:38:50 - 1.1
+++ iishowto.xml 9 Sep 2002 09:57:10 - 1.2
@@ -10,11 +10,18 @@
p
This document explains how to set up IIS to cooperate with Tomcat.
/p
+
p
Normally IIS can not execute Servlets and Java Server Pages (JSPs),
configuring IIS to use the mod_jk redirector plugin will let IIS send servlet and
JSP requests to Tomcat (and this way, serve them to clients).
/p
+
+p
+We recommand you to read also the a href=jk/workershowto.htmlWorkers HowTo/a
document
+to learn how to setup the working entities between your WebServer and Tomcat
Engines.
+/p
+
subsection name=Document Conventions and Assumptions
p
--
To unsubscribe, e-mail: mailto:[EMAIL PROTECTED]
For additional commands, e-mail: mailto:[EMAIL PROTECTED]
cvs commit: jakarta-tomcat-connectors/jk/xdocs/jk domhowto.xml
hgomez 2002/09/05 05:51:26
Added: jk/xdocs/jk domhowto.xml
Log:
Domino/JK initial documentation
Revision ChangesPath
1.1 jakarta-tomcat-connectors/jk/xdocs/jk/domhowto.xml
Index: domhowto.xml
===
?xml version=1.0 encoding=ISO-8859-1 ?
document
properties
titleDomino HowTo/title
author email=[EMAIL PROTECTED]Andy Armstrong/author
author email=[EMAIL PROTECTED]Henri Gomez/author
/properties
section name=Introduction
p
This document explains how to set up Domino to cooperate with Tomcat.
/p
p
Recent version of the Lotus Domino web server have had the ability to host Java
servlets,
but at the time of writing the Domino servlet container uses JDK 1.2.2 and it is not
(apparently)
possible to replace this with JDK 1.3.
/p
p
That means if you want to use JAAS or any other API
that is JDK 1.3 only in your servlets you're stuck.
/p
subsection name=Document Conventions and Assumptions
p
${tomcat_home} is the root directory of tomcat.
Your Tomcat installation should have the following subdirectories:
ul
li
${tomcat_home}\conf - Where you can place various configuration files
/li
li
${tomcat_home}\webapps - Containing example applications
/li
li
${tomcat_home}\bin - Where you place web server plugins
/li
/ul
/p
p
In all the examples in this document ${tomcat_home} will be bc:\jakarta-tomcat/b.
A worker is defined to be a tomcat process that accepts work from the IIS server.
/p
/subsection
subsection name=Supported Configuration
p
The Domino Tomcat redirector was developed and tested on:
ul
li
WinNT4.0-i386 SP6a (it should be able to work on other versions of the NT service
pack.) and Win2K Professional
/li
li
RedHat Linux 7
/li
li
Lotus Domino 5.0.6a
/li
li
Tomcat 3.2.x, Tomcat 3.3.x, Tomcat 4.0.x, Tomcat 4.1.x and Tomcat 5
/li
/ul
/p
p
The redirector uses bajp12/b and bajp13/b to send requests to the Tomcat
containers.
It probably also works with Tomcat in process, but that hasn't been tested.
/p
/subsection
subsection name=Who support ajp protocols ?
p
The ajp12 protocol is only available in Tomcat 3.2.x and 3.3.x.
/p
p
The bajp12/b has been bdeprecated/b with Tomcat 3.3.x and you should use
instead
bajp13/b which is the only ajp protocol known by Tomcat 4.0.x, 4.1.x and 5.
/p
p
Of course Tomcat 3.2.x and 3.3.x also support ajp13 protocol.
/p
p
Others servlet engines such as bjetty/b have support for ajp13 protocol
/p
/subsection
/section
section name=Installation on Windows
p
The Tomcat redirector requires 3 entities:
/p
ul
li
tomcat_redirect.dll - The Domino plugin, either obtain a pre-built DLL or build it
yourself
(see the build section).
/li
li
workers.properties - A file that describes the host(s) and port(s) used by the
workers (Tomcat processes).
A sample workers.properties can be found under the conf directory.
/li
li
tomcat_redirector.reg - Registry entries
/li
/ul
p
We'll assume that tomcat redirector is placed in
bc:\jk\lib\tomcat_redirector.dll/b,
the properties file is inbc:\jk\conf/b
and you created a log directory bc:\jk\logs/b
/p
p
Copy the file btomcat_redirector.dll/b to the Domino program directory
(this is the directory, which may be called something like bc:\Lotus\Domino/b,
that contains a file called
bnlnotes.exe/b).
/p
screendos
notedosCopy redirector dll to Domino program directory/notedos
typedoscopy c:\jk\lib\tomcat_redirector.dll c:\Lotus\Domino/typedos
/screendos
p
Shortly we will tell Domino where to find this file, but before we do that we need
to make some registry entries.
The simplest way is to edit the supplied file btomcat_redirector.reg/b, which
initially will look like this :
/p
screen
readREGEDIT4/read
read/
read[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Dsapi
Redirector\1.0]/read
readlog_file=c:\\jk\\logs\\domino.log/read
readlog_level=debug/read
readworker_file=c:\\jk\\conf\\workers.properties/read
readworker_mount_file=c:\\jk\\conf\\uriworkermap.properties/read
readtomcat_start=c:\\jakarta-tomcat\\bin\\tomcat.bat start/read
readtomcat_stop=c:\\jakarta-tomcat\\bin\\tomcat.bat stop/read
/screen
p
Edit this file to reflect the location where Tomcat has been installed, i.e. replace
the instances
of bc:\\jakarta-tomcat/b and bc:\\jk/b with the appropriate path remembering
to bretain the double backslashes/b.
/p
p
Once you've made the necessary changes save this file and double click on it to
enter it into the registry.
/p
p
Note that the files referred to by the worker_file and worker_mount_file keys need
to exist and contain sane values.
Default Tomcat installations will
