You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by mt...@apache.org on 2004/11/18 19:27:48 UTC
cvs commit: jakarta-tomcat-connectors/jk/xdocs build.xml project.xml style.css style.xsl .cvsignore faq.xml index.xml
mturk 2004/11/18 10:27:48
Modified: jk/xdocs .cvsignore faq.xml index.xml
Added: jk/xdocs build.xml project.xml style.css style.xsl
Log:
Add new style documents
Revision Changes Path
1.4 +0 -3 jakarta-tomcat-connectors/jk/xdocs/.cvsignore
Index: .cvsignore
===================================================================
RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/.cvsignore,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- .cvsignore 18 Nov 2004 18:16:41 -0000 1.3
+++ .cvsignore 18 Nov 2004 18:27:48 -0000 1.4
@@ -1,5 +1,2 @@
-style.css
-style.xsl
-menu.idx
jk
jk2
1.11 +30 -29 jakarta-tomcat-connectors/jk/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/faq.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- faq.xml 4 Mar 2004 04:46:33 -0000 1.10
+++ faq.xml 18 Nov 2004 18:27:48 -0000 1.11
@@ -1,5 +1,10 @@
<?xml version="1.0"?>
-<document>
+<!DOCTYPE document [
+ <!ENTITY project SYSTEM "project.xml">
+]>
+<document url="faq.html">
+
+ &project;
<copyright>
Copyright 1999-2004 The Apache Software Foundation
@@ -20,7 +25,7 @@
<author email="hgomez@apache.org">Henri Gomez</author>
<date>$Date$</date>
</properties>
-
+<body>
<section name="General">
<p>
General Informations and FAQ about JK
@@ -67,17 +72,17 @@
</p>
<p>
-<a href="jk/domhowto.html">Domino webserver</a> support is implemented on JK, using a redirector
+<a href="howto/domino.html">Domino webserver</a> support is implemented on JK, using a redirector
called <b>dsapi redirector</b>.
</p>
<p>
-<a href="jk/iishowto.html">IIS webserver</a>support is implemented on JK, using a redirector
+<a href="howto/iis.html">IIS webserver</a>support is implemented on JK, using a redirector
called <b>isapi redirector</b>.
</p>
<p>
-<a href="jk/neshowto.html">Netscape/iPlanet webserver</a>webserver support is implemented on JK, using a redirector
+<a href="howto/nes.html">Netscape/iPlanet webserver</a>webserver support is implemented on JK, using a redirector
called <b>nsapi redirector</b>.
</p>
@@ -91,43 +96,39 @@
<ul>
<li>
-<a href="jk/quickhowto.html">For the impatients</a>
+<a href="howto/quick.html">For the impatients</a>
</li>
<li>
-<a href="jk/aphowto.html">Apache and JK</a>
+<a href="howto/apache.html">Apache and JK</a>
</li>
<li>
-<a href="jk/domhowto.html">Domino and JK</a>
+<a href="howto/domino.html">Domino and JK</a>
</li>
<li>
-<a href="jk/iishowto.html">IIS and JK</a>
+<a href="howto/iis.html">IIS and JK</a>
</li>
<li>
-<a href="jk/neshowto.html">Netscape/iPlanet and JK</a>
+<a href="howto/nes.html">Netscape/iPlanet and JK</a>
</li>
<li>
-<a href="jk/workershowto.html">Workers configuration</a>
+<a href="howto/workers.html">Workers configuration</a>
</li>
</ul>
-<p>
-For <b>JK 2.0.x</b> the <a href="jk2/configtc.html">
-config tomcat</a> and <a href="jk2/configweb.html">config webserver</a>
-documents have considerably more in-depth information.
-It's worth a look.
+<p>
You could also try searching the mailing list archives for "JK" or look at the source.
</p>
</subsection>
<subsection name="Which protocol should I use? Ajp12 or Ajp13?">
<p>
-<a href="common/AJPv13.html">Ajp13</a> is a newer protocol, it's faster, and it works better with SSL.
-You almost certainly want to use it now that ajp12 is deprecated.
+<a href="common/ajpv13.html">Ajp13</a> is a newer protocol, it's faster, and it works better with SSL.
+You almost certainly want to use it now that <strong>ajp12 is deprecated</strong>.
</p>
<p>
Also ajp13 is supported by all Apache Tomcat including 3.2.x , 3.3.x, 4.0.x, 4.1.x and the new tomcat 5.
@@ -145,7 +146,7 @@
</p>
<p>
Starting with JK 1.2.0, a <b>socket_keepalive</b> property as been added to ajp13 settings, and you should take a look at
-it in <a href="jk/workershowto.html">Workers HowTo</a>.
+it in <a href="howto/workers.html">Workers HowTo</a>.
</p>
</subsection>
@@ -158,8 +159,8 @@
even if they are no more used.
</p>
<p>
-Since JK 1.2.0, <b>cache_timeout</b> and <b>socket_timeout</b> properties as been added to close
-connections after some time of inactivity, for more informations refer to <a href="jk/workershowto.html">Workers HowTo</a>.
+Since JK 1.2.0, <b>cache_timeout</b> and <b>recycle_timeout</b> properties as been added to close
+connections after some time of inactivity, for more informations refer to <a href="howto/workers.html">Workers HowTo</a>.
</p>
</subsection>
@@ -259,10 +260,10 @@
the pthreads library to your <b>httpd.conf</b> file.
</p>
-<screen>
-<note># Add pthread to Apache in httpd.conf</note>
-<read>LoadModule "/usr/lib/libpthreads.so"</read>
-</screen>
+<source>
+ # Add pthread to Apache in httpd.conf
+ LoadModule "/usr/lib/libpthreads.so"
+</source>
<p>
Also keep in mind that JNI is suited for multi-threaded servers and you should consider upgrading
@@ -322,7 +323,7 @@
Informations and FAQ about JK and IIS Web Servers.
</p>
<todo>
-More informations to be added, Nacho ?
+More informations to be added.
</todo>
</section>
@@ -331,9 +332,9 @@
Informations and FAQ about JK and NES/iPlanet Web Servers.
</p>
<todo>
-More informations to be added, Mike ?
+More informations to be added.
</todo>
</section>
-
+</body>
</document>
1.20 +81 -128 jakarta-tomcat-connectors/jk/xdocs/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/index.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- index.xml 5 Oct 2004 10:01:04 -0000 1.19
+++ index.xml 18 Nov 2004 18:27:48 -0000 1.20
@@ -1,155 +1,108 @@
<?xml version="1.0"?>
-<document>
-<copyright>
- Copyright 1999-2004 The Apache Software Foundation
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
-</copyright>
-<properties>
-<title>Overview</title>
-<author email="jfrederic.clere@fujitsu-siemens.com">Jean-Frederic Clere</author>
-<author email="hgomez@apache.org">Henri Gomez</author>
-<author email="yoavs@apache.org">Yoav Shapira</author>
-<date>$Date$</date>
-</properties>
-
-<section name="What's JK?">
-<p>
-<b>JK</b> is a replacement to the elderly mod_jserv.
-It was a completely new Tomcat-Apache plug-in that handles the communication between Tomcat and Apache.
-</p>
-<p>
-The newest <b>JK2</b> is a refactoring of <b>JK</b>.
-The native part has been completly
-restructured and the configuration has been simplified a lot.
-</p>
+<!DOCTYPE document [
+ <!ENTITY project SYSTEM "project.xml">
+]>
+<document url="index.html">
+
+ &project;
+
+ <properties>
+ <author email="mturk@apache.org">Mladen Turk</author>
+ <title>Documentation Index</title>
+ </properties>
+
+<body>
+
+<section name="Introduction">
+
+<p>This is the top-level entry point of the documentation bundle for the
+<strong>Apache Jakarta Tomcat Connectors</strong>
-<p>
-JK is more than just an apache module, since it could be used with majors WebServer :
</p>
+<p>Select one of the links from the navigation menu (to the left) to drill
+down to the more detailed documenation that is available. Each available
+manual is described in more detail below.</p>
+
+</section>
+<section name="Headlines">
+<br />
<ul>
-<li>
-<a href="jk/aphowto.html">mod_jk</a> is an Apache module to be used with <b>Apache 1.3</b> and <b>2.0</b> Webservers.
-</li>
-<li>
-<a href="jk/iishowto.html">isapi</a> is a redirector to be used with <b>IIS</b>.
-</li>
-<li>
-<a href="jk/neshowto.html">nsapi</a> is a redirector to be used with <b>Netscape/iPlanet</b>.
-</li>
-<li>
-<a href="jk/domhowto.html">dsapi</a> is a redirector to to be used with <b>Domino</b>.
+<li><a href="news/20041100.html#20041115.1">15 November 2004 - <b>JK2 is officially unsupported!</b></a>
+<p>JK2 has been put in maintainer mode and no further development will take place.
+The reason for shutting down JK2 development was the lack of developers interest.
+Other reason was lack of users interest in adopting JK2, caused by configuration
+complexity when compared to JK.
+</p>
+<p>JK2 will have it's successor within core Apache2.1/2.2 distribution.
+We have developed new <b>proxy_ajp</b> that is an addition to
+the mod_proxy and uses Tomcat's AJP protocol stack. It is developped in httpd-2.1
+and integrated in it. We have also developed a new <b>proxy_balancer</b> module
+for load balancing http and ajp protocol stacks.
+</p>
+<p>JK will be fully supported for all other web servers. The next JK release is
+planned for the end of November. Lots of code from JK2 has been ported to JK
+</p>
</li>
</ul>
-
</section>
-<section name="Why should I use the JK?">
-<p>
-JK was develop to overcome many limitations of its ancestor, <b>mod_jserv</b>.
+<section name="Configuration">
+<br />
+<ul>
+<li><a href="config/workers.html"><b>Workers.properties Documentation</b></a>
+<p>To be done! This section contains detail description of all workers.properties
+directives.
</p>
+</li>
-<p>
-<b>mod_jserv</b> was too complex and because it was ported from Apache/JServ,
-it brought with it lots of JServ specific bits that aren't needed by Apache.
+<li><a href="config/apache1.html"><b>Apache Documentation</b></a>
+<p>To be done! This section contains detail description of all Aapache directives.
</p>
-
-<p>
-Where <b>mod_jserv</b> supported only Apache webservers on Unix OS,
-<b>JK</b> supports much more web servers and operating systems through
-via a compatibility layer named the <b>JK library</b>.
-The layered approach provided by the JK library makes it easier to
-support many different webservers and OS.
+</li>
+<li><a href="config/apache1.html"><b>IIS Documentation</b></a>
+<p>To be done! This section contains detail description of all IIS directives.
</p>
+</li>
-<p>
-JK offer better support for SSL, that's was a problem with mod_jserv which couldn't
-reliably identify whether a request was made via HTTP or HTTPS.
+</ul>
+</section>
+
+<section name="Installation">
+<br />
+<ul>
+<li><a href="install/apache1.html"><b>Apache 1.3.x installation documentation</b></a>
+<p>To be done! This section contains detail description of how to build and
+install mod_jk for Apache 1.3.x web server.
</p>
-<p>
-JK can, using the newer Ajpv13 protocol which relay many SSL informations required by servlet 2.2 and 2.3 specs.
+</li>
+<li><a href="install/apache2.html"><b>Apache 2.0.x installation documentation</b></a>
+<p>To be done! This section contains detail description of how to build and
+install mod_jk for Apache 2.0.x web server.
</p>
+</li>
-<p>
-JK offers a lot of different and flexible communications between a Web Server
-and the Tomcat Servlet Engine and could be used today with all of the ASF Tomcat Engines,
-<b>3.2.x</b>, <b>3.3.x</b>, <b>4.0.x</b>, <b>4.1.x</b> and <b>5.x</b>
+<li><a href="install/iis.html"><b>IIS installation documentation</b></a>
+<p>To be done! This section contains detail description of how to build and
+install isapi_redirector for IIS web server.
</p>
+</li>
-</section>
-
-<section name="What's the difference between JK and JK2?">
-<p>
-JK2 is a refactoring of JK and is much more powerfull.
-</p>
-<p>
-Even if it works with Apache 1.3, JK2 has been developed with Apache 2.0 in mind,
-and is better suited for multi-threaded servers like IIS, NES/iPlanet. It can also
-be embeded in other applications and used from java.
-</p>
-<p>
-JK2 improves the modularity and has a better separation between protocol and physical layer.
-As such JK2 support fast unix-socket, and could be extended to support others communications
-channels. It is better suited for JNI and may use (in a future version) JDK 1.4 NIO.
-</p>
-<p>
-There is additional support for monitoring, similar with JMX in java. A module similar
-with mod_status is provided, and additional adapters can be used to interface and
-provide status and runtime configuration. .
-</p>
-<p>
-The configuration has been changed to follow the component models. Multiple configuration
-sources can be supported ( in additon to file ) providing better integration with
-the embeding application. The config layer uses the management layer APIs and it can
-support persistence for changes done via runtime configuration.
-</p>
-<p>
-Another feature is the JNI mode. Jk2 can be used as a JNI library and provide access to
-native features to java. For example it provides access to shared memory ( used for
-config and monitoring in a multiprocess environment ), unix domain sockets. It can
-also provide access to signals, chuid, win registry. All using the same communication
-mechansim, and supporting both in-process and out-of process modes.
-</p>
+</ul>
</section>
-<section name="Are there alternative ways to connect Apache and Tomcat?">
-<p>
-<b>Tomcat's AJP stack and httpd-2.1 AJP proxy</b> that is an addition to the mod_proxy of http. It is developped in httpd-2.1 and integrated in it.
-(See <a href="proxy.xml">AJP proxy</a>).
-</p>
-<p>
-<b>Tomcat's internal HTTP stack and mod_proxy</b> which is not that bad, but slow,
-well, of course Tomcat didn't have 10/11 years of C routine optimization like
-the Apache Web Server, but it's quite good. The only disadvantage is that it
-looks pretty ridiculous to parse an HTTP request to generate it again
-(exactly the same), and to parse again the response to send it back unchanged...
-</p>
-<p>
-<a href="http://jakarta.apache.org/~jfclere/webapp_docs/">mod_webapp</a> which is very easy to configure, has a well defined protocol named
-<a href="http://jakarta.apache.org/~jfclere/webapp_docs/warp.html">WARP</a> but it is no longer developped.
-BTW: It would be possible to implement the <b>WARP</b> protocol in
-<b>JK2</b> ;-))
+<section name="Documentation">
+<br />
+<ul>
+<li><a href="howto/index.html"><b>HowTo Documentation</b></a>
+<p>This section contains various howto documents
</p>
-</section>
+</li>
+</ul>
-<section name="Additional References">
-<p>
-Please note that we maintain a list of references to external documentation
-on connector usage and configuration in various environments as part of
-the Tomcat wiki <a href="http://wiki.apache.org/jakarta-tomcat/Tomcat_2fLinks">Useful Links</a> page.
-</p>
</section>
+
+</body>
</document>
1.1 jakarta-tomcat-connectors/jk/xdocs/build.xml
Index: build.xml
===================================================================
<project name="tomcat-docs" default="build-main" basedir=".">
<!-- ===================== Initialize Property Values =================== -->
<!-- See "build.properties.sample" in the top level directory for all -->
<!-- property values you must customize for successful building!!! -->
<property file="build.properties"/>
<property file="../build.properties"/>
<property file="../../build.properties"/>
<property file="${user.home}/build.properties"/>
<property name="build.compiler" value="modern"/>
<property name="build.dir" value="../build"/>
<property name="dist.dir" value="../dist"/>
<property name="dist.name" value="docs"/>
<!-- =================== BUILD: Create Directories ====================== -->
<target name="build-prepare">
<mkdir dir="${build.dir}"/>
<mkdir dir="${build.dir}/${dist.name}"/>
</target>
<!-- ================ BUILD: Copy Static Files ========================== -->
<target name="build-static" depends="build-prepare">
<!-- Top Level Static Files -->
<copy todir="${build.dir}/${dist.name}">
<fileset dir=".">
<include name="BUILDING.txt"/>
<include name="README.txt"/>
<include name="RUNNING.txt"/>
<include name="style.css"/>
</fileset>
</copy>
<copy todir="${build.dir}/${dist.name}">
<fileset dir="." includes="**/*.html"/>
</copy>
<!-- Images Subdirectory -->
<mkdir dir="${build.dir}/${dist.name}/images"/>
<copy todir="${build.dir}/${dist.name}/images">
<fileset dir="images"/>
</copy>
<mkdir dir="${build.dir}/${dist.name}/printer"/>
<!-- Top Level Static Files -->
<copy todir="${build.dir}/${dist.name}/printer">
<fileset dir=".">
<include name="BUILDING.txt"/>
<include name="README.txt"/>
<include name="RUNNING.txt"/>
</fileset>
</copy>
<style basedir="."
destdir="${build.dir}/${dist.name}/printer"
extension=".html"
style="style.xsl"
excludes="build.xml project.xml"
includes="*.xml">
<param name="relative-path" expression="./.."/>
<param name="project-menu" expression="nomenu"/>
</style>
<!-- News -->
<style basedir="news"
destdir="${build.dir}/${dist.name}/news"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression=".."/>
</style>
<mkdir dir="${build.dir}/${dist.name}/news/printer"/>
<style basedir="news"
destdir="${build.dir}/${dist.name}/news/printer"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression="../.."/>
<param name="project-menu" expression="nomenu"/>
</style>
<!-- Common -->
<style basedir="common"
destdir="${build.dir}/${dist.name}/common"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression=".."/>
</style>
<mkdir dir="${build.dir}/${dist.name}/common/printer"/>
<style basedir="common"
destdir="${build.dir}/${dist.name}/common/printer"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression="../.."/>
<param name="project-menu" expression="nomenu"/>
</style>
<!-- Howto -->
<style basedir="howto"
destdir="${build.dir}/${dist.name}/howto"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression=".."/>
</style>
<mkdir dir="${build.dir}/${dist.name}/howto/printer"/>
<style basedir="howto"
destdir="${build.dir}/${dist.name}/howto/printer"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression="../.."/>
<param name="project-menu" expression="nomenu"/>
</style>
<!-- Config -->
<style basedir="config"
destdir="${build.dir}/${dist.name}/config"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression=".."/>
</style>
<mkdir dir="${build.dir}/${dist.name}/config/printer"/>
<style basedir="config"
destdir="${build.dir}/${dist.name}/config/printer"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression="../.."/>
<param name="project-menu" expression="nomenu"/>
</style>
<!-- Install -->
<style basedir="install"
destdir="${build.dir}/${dist.name}/install"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression=".."/>
</style>
<mkdir dir="${build.dir}/${dist.name}/install/printer"/>
<style basedir="install"
destdir="${build.dir}/${dist.name}/install/printer"
extension=".html"
style="style.xsl"
excludes="project.xml"
includes="*.xml">
<param name="relative-path" expression="../.."/>
<param name="project-menu" expression="nomenu"/>
</style>
</target>
<!-- ================= BUILD: XML-HTML Generation ======================= -->
<target name="build-main" depends="build-static">
<!-- Top Level Directory -->
<style basedir="."
destdir="${build.dir}/${dist.name}"
extension=".html"
style="style.xsl"
excludes="build.xml project.xml"
includes="*.xml">
<param name="relative-path" expression="."/>
</style>
</target>
<!-- ==================== BUILD: Rebuild Everything ===================== -->
<target name="all" depends="build-clean,build-main"
description="Clean and build documentation"/>
<!-- ======================= BUILD: Clean Directory ===================== -->
<target name="build-clean">
<delete dir="${build.dir}/${dist.name}"/>
</target>
<!-- ======================= DIST: Create Directories =================== -->
<target name="dist-prepare">
<mkdir dir="${dist.dir}"/>
</target>
<!-- ======================= DIST: Create Distribution Files ============ -->
<target name="dist" depends="build-main,dist-prepare"
description="Create documentation binary distribution">
<jar jarfile="${dist.dir}/${dist.name}.war"
basedir="${build.dir}/${dist.name}" includes="**"/>
</target>
<!-- ======================= DIST: Clean Directory ====================== -->
<target name="dist-clean">
<delete dir="${dist.dir}/${dist.name}"/>
</target>
<!-- ====================== Convenient Synonyms ========================= -->
<target name="clean" depends="build-clean,dist-clean"
description="Clean build and dist directories"/>
</project>
1.1 jakarta-tomcat-connectors/jk/xdocs/project.xml
Index: project.xml
===================================================================
<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="Apache Jakarta Tomcat Connector Documentation - Top Level Directory"
href="http://jakarta.apache.org/tomcat/">
<title>The Apache Jakarta Tomcat Connector</title>
<logo href="/images/tomcat.gif">
The Apache Jakarta Tomcat Connector
</logo>
<body>
<menu name="Links">
<item name="Docs Home" href="index.html"/>
</menu>
<menu name="Configuration">
<item name="Workers.properties" href="config/workers.html"/>
<item name="Apache" href="config/apache.html"/>
<item name="IIS" href="config/iis.html"/>
</menu>
<menu name="Installation">
<item name="Apache 1.3" href="install/apache1.html"/>
<item name="Apache 2.0" href="install/apache2.html"/>
<item name="IIS" href="install/iis.html"/>
</menu>
<menu name="Documentation">
<item name="AJPv13 Protocol" href="common/ajpv13a.html"/>
<item name="HowTo" href="howto/index.html"/>
<item name="Frequently asked questions" href="faq.html"/>
</menu>
</body>
</project>
1.3 +37 -140 jakarta-tomcat-connectors/jk/xdocs/style.css
1.3 +466 -407 jakarta-tomcat-connectors/jk/xdocs/style.xsl
---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org