Author: rjung
Date: Thu Mar 5 11:42:14 2009
New Revision: 750429
URL: http://svn.apache.org/viewvc?rev=750429&view=rev
Log:
Add deprecation warning about JNI to the docs.
Modified:
tomcat/connectors/trunk/jk/xdocs/generic_howto/workers.xml
tomcat/connectors/trunk/jk/xdocs/miscellaneous/changelog.xml
tomcat/connectors/trunk/jk/xdocs/miscellaneous/faq.xml
tomcat/connectors/trunk/jk/xdocs/news/20090301.xml
tomcat/connectors/trunk/jk/xdocs/reference/workers.xml
tomcat/connectors/trunk/jk/xdocs/webserver_howto/apache.xml
Modified: tomcat/connectors/trunk/jk/xdocs/generic_howto/workers.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/generic_howto/workers.xml?rev=750429&r1=750428&r2=750429&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/generic_howto/workers.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/generic_howto/workers.xml Thu Mar 5
11:42:14 2009
@@ -103,7 +103,7 @@
<tr><th>Type</th><th>Description</th></tr>
<tr><td>ajp12</td><td>This worker knows how to forward requests to
out-of-process Tomcat workers using the ajpv12 protocol.</td></tr>
<tr><td>ajp13</td><td>This worker knows how to forward requests to
out-of-process Tomcat workers using the ajpv13 protocol.</td></tr>
- <tr><td>jni</td><td>This worker knows how to forward requests to in-process
Tomcat workers using JNI.</td></tr>
+ <tr><td>jni</td><td>DEPRECATED: This worker knows how to forward requests to
in-process Tomcat workers using JNI.</td></tr>
<tr><td>lb</td><td>This is a load-balancing worker; it knows how to provide
round-robin based sticky load balancing with a certain level of
fault-tolerance.</td></tr>
<tr><td>status</td><td>This is a status worker for managing load
balancers.</td></tr>
</table>
@@ -123,8 +123,6 @@
worker.local.type=ajp12
# Defines a worker named "remote" that uses the ajpv13 protocol to forward
requests to a Tomcat process.
worker.remote.type=ajp13
- # Defines a worker named "fast" that uses JNI to forward requests to a
Tomcat process.
- worker.fast.type=jni
# Defines a worker named "loadbalancer" that loadbalances several Tomcat
processes transparently.
worker.loadbalancer.type=lb
</source>
@@ -308,19 +306,17 @@
<p>
You can define "macros" in the property files.
These macros let you define properties and later on use them while
-constructing other properties and it's very useful when you want to
-change your Java Home, Tomcat Home or OS path separator
+constructing other properties.
</p>
<source>
- # property example, don't hardcode path separator
- ps=\
- workers.tomcat_home=d:\tomcat
- workers.java_home=d:\sdk\jdk1.2.2
- # Using macros we'll have : worker.inprocess.class_path=d:\tomcat\classes
- worker.inprocess.class_path=$(workers.tomcat_home)$(ps)classes
- # Using macros we'll have :
worker.inprocess.class_path=d:\sdk\jdk1.2.2\lib\tools.jar
- worker.inprocess.class_path=$(workers.java_home)$(ps)lib$(ps)tools.jar
+ # property example, like a network base address
+ mynet=194.226.31
+ # Using the above macro to simplify the address definitions
+ # for a farm of workers.
+ worker.node1.host=$(mynet).11
+ worker.node2.host=$(mynet).12
+ worker.node3.host=$(mynet).13
</source>
</subsection>
Modified: tomcat/connectors/trunk/jk/xdocs/miscellaneous/changelog.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/miscellaneous/changelog.xml?rev=750429&r1=750428&r2=750429&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/miscellaneous/changelog.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/miscellaneous/changelog.xml Thu Mar 5
11:42:14 2009
@@ -44,6 +44,9 @@
<subsection name="Native">
<changelog>
<update>
+ JNI: Deprecate JNI workers. (rjung)
+ </update>
+ <update>
Docs: Add a new HowTo page about reverse proxies. (rjung)
</update>
<update>
Modified: tomcat/connectors/trunk/jk/xdocs/miscellaneous/faq.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/miscellaneous/faq.xml?rev=750429&r1=750428&r2=750429&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/miscellaneous/faq.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/miscellaneous/faq.xml Thu Mar 5 11:42:14
2009
@@ -263,6 +263,7 @@
</subsection>
<subsection name="JNI doesn't work with Apache 1.3">
+<warn>JNI workers have been deprecated. They will likely not work. Do not use
them.</warn>
<p>
JNI support requires a multi-threaded environment which is not the general
case for Apache 1.3.
You should verify if Apache 1.3 has been build with thread support and if not
you could add the
@@ -281,6 +282,7 @@
</subsection>
<subsection name="JNI report that JVM couldn't be started under Linux">
+<warn>JNI workers have been deprecated. They will likely not work. Do not use
them.</warn>
<p>
Under Linux, you should set some environment variables BEFORE launching your
Apache server :
</p>
Modified: tomcat/connectors/trunk/jk/xdocs/news/20090301.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/news/20090301.xml?rev=750429&r1=750428&r2=750429&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/news/20090301.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/news/20090301.xml Thu Mar 5 11:42:14 2009
@@ -65,12 +65,17 @@
This is helpful in case there are other reverse proxies in front of your web
server.
A new <a href="../generic_howto/proxy.html">documentation page</a> explains
this in detail.
</p>
-<h3>Improved IIS support</h3>
+<h3>Improved IIS Support</h3>
<p>
IIS support has been improved especially when using mutltiple application
pools.
Furthermore you can now configure the ISAPI plugin to update the
uriworkermap.properies
file on a regular interval using the watchdog thread.
</p>
+<h3>JNI Worker Deprecation</h3>
+<p>
+Workers of type jni are broken since a long time. Since there is no more
+use for them, they have been deprecated now, and will be removed in a future
release.
+</p>
</subsection>
</section>
</body>
Modified: tomcat/connectors/trunk/jk/xdocs/reference/workers.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/reference/workers.xml?rev=750429&r1=750428&r2=750429&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/reference/workers.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/reference/workers.xml Thu Mar 5 11:42:14
2009
@@ -218,6 +218,7 @@
channel. For detailed description of the AJP13 protocol stack browse to
<a href="../ajp/ajpv13a.html">AJPv13 protocol specification</a>
</p>
+<warn>JNI workers have been deprecated. They will likely not work. Do not use
them.</warn>
</directive>
</directives>
</subsection>
Modified: tomcat/connectors/trunk/jk/xdocs/webserver_howto/apache.xml
URL:
http://svn.apache.org/viewvc/tomcat/connectors/trunk/jk/xdocs/webserver_howto/apache.xml?rev=750429&r1=750428&r2=750429&view=diff
==============================================================================
--- tomcat/connectors/trunk/jk/xdocs/webserver_howto/apache.xml (original)
+++ tomcat/connectors/trunk/jk/xdocs/webserver_howto/apache.xml Thu Mar 5
11:42:14 2009
@@ -986,7 +986,7 @@
</table>
<br/>
<table>
- <tr valign="top"><th>JNI related parameters</th><th></th></tr>
+ <tr valign="top"><th>DEPRECATED: JNI related parameters</th><th></th></tr>
<tr valign="top"><td>--enable-jni</td>
<td>Build the JNI worker and so the build process will require
some information about your Java Environment</td>
@@ -1005,6 +1005,7 @@
</tr>
</table>
</p>
+<warn>The JNI option has been deprecated. It will likely not work. Do not use
it.</warn>
</subsection>
<subsection name="Examples of configure use">
@@ -1026,12 +1027,7 @@
<typenext>--with-java-home=${JAVA_HOME} --with-java-platform=2 \</typenext>
<typenext>--enable-jni</typenext><br/>
</screen>
-
-<screen>
-<note>Apache 1.3 build without JNI support</note>
-<type>./configure --with-apxs=/usr/sbin/apxs</type><br/>
-</screen>
-
+<warn>The JNI option has been deprecated. It will likely not work. Do not use
it.</warn>
</subsection>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
