Author: schultz
Date: Thu Jul 25 20:34:30 2013
New Revision: 1507114
URL: http://svn.apache.org/r1507114
Log:
Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=51655
Added a decent description of what tcnative actually is.
Modified:
tomcat/native/branches/1.1.x/ (props changed)
tomcat/native/branches/1.1.x/xdocs/index.xml
tomcat/native/branches/1.1.x/xdocs/miscellaneous/changelog.xml
tomcat/native/branches/1.1.x/xdocs/project.xml
Propchange: tomcat/native/branches/1.1.x/
------------------------------------------------------------------------------
Merged /tomcat/native/trunk:r1507113
Modified: tomcat/native/branches/1.1.x/xdocs/index.xml
URL:
http://svn.apache.org/viewvc/tomcat/native/branches/1.1.x/xdocs/index.xml?rev=1507114&r1=1507113&r2=1507114&view=diff
==============================================================================
--- tomcat/native/branches/1.1.x/xdocs/index.xml (original)
+++ tomcat/native/branches/1.1.x/xdocs/index.xml Thu Jul 25 20:34:30 2013
@@ -31,8 +31,28 @@
<section name="Introduction">
-<p>This is the top-level entry point of the documentation bundle for the
-<strong>Apache Tomcat Native</strong>
+ <p>
+ The Apache Tomcat Native Library is an optional component for use with
+ Apache Tomcat that allows Tomcat to use certain native resources
+ for performance, compatibility, etc.
+ </p>
+
+ <p>
+ Specifically, the Apache Tomcat Native Library gives Tomcat access to
+ the Apache Portable Runtime (APR) library's network connection (socket)
+ implementation and random-number generator.
+ See the Apache Tomcat documentation for more information on how to
+ configure Tomcat to use the APR connector.
+ </p>
+
+ <p>
+ Features of the APR connector:
+ </p>
+ <ul>
+ <li>Non-blocking I/O for Keep-Alive requests (between requests)</li>
+ <li>Uses OpenSSL for TLS/SSL capabilities (if supported by linked APR
library)</li>
+ <li>FIPS 140-2 support for TLS/SSL (if supported by linked OpenSSL
library)</li>
+ </ul>
</p>
<p>Select one of the links from the navigation menu (to the left) to drill
@@ -148,6 +168,20 @@ manual is described in more detail below
</section>
<section name="Install and tests">
+ <subsection name="Configuring Tomcat">
+ <p>
+ Apache Tomcat comes with the <code>AprLifecycleListener</code> enabled
+ by default. Still, you should check your <code>conf/server.xml</code>
+ to ensure that something like the following is present, and uncommented:
+ </p>
+
+ <pre>
+ <Listener className="org.apache.catalina.core.AprLifecycleListener"
SSLEngine="on" />
+ </pre>
+
+ Please see the Apache Tomcat documentation for configuration specifics.
+ </subsection>
+
<subsection name="UNIX">
<p>
Edit $CATALINA_HOME/bin/setenv.sh (creating the file if necessary) and add
@@ -175,10 +209,14 @@ manual is described in more detail below
<p>
Edit $CATALINA_BASE\bin\setenv.bat (creating the file if necessary) and add
the path to the tc-native libraries, apr and OpenSSL to PATH. For example:
- <pre>
+ <p>
+
+ <pre style="white-space:pre-wrap; word-wrap:break-word;">
set
PATH=%PATH;C:\cygwin\home\support\tomcat-native-current-win32-src\jni\native\Debug;C:\cygwin\home\support\tomcat-native-current-win32-src\jni\apr\Debug;C:\OpenSSL\lib\VC
</pre>
+ <p>
Start tomcat and check for the messages like this ones:
+ </p>
<pre>
Feb 8, 2008 2:48:17 PM org.apache.catalina.core.AprLifecycleListener init
INFO: Loaded APR based Apache Tomcat Native library 1.x.y.
Modified: tomcat/native/branches/1.1.x/xdocs/miscellaneous/changelog.xml
URL:
http://svn.apache.org/viewvc/tomcat/native/branches/1.1.x/xdocs/miscellaneous/changelog.xml?rev=1507114&r1=1507113&r2=1507114&view=diff
==============================================================================
--- tomcat/native/branches/1.1.x/xdocs/miscellaneous/changelog.xml (original)
+++ tomcat/native/branches/1.1.x/xdocs/miscellaneous/changelog.xml Thu Jul 25
20:34:30 2013
@@ -46,6 +46,9 @@
Minimum supported APR version is now again 1.2.1. Version 1.3.0
of APR improves performance. (rjung)
</update>
+ <fix>
+ <bug>51655</bug> Added a decent description of what tcnative actually is.
+ </fix>
</changelog>
</section>
<section name="Changes between 1.1.26 and 1.1.27">
Modified: tomcat/native/branches/1.1.x/xdocs/project.xml
URL:
http://svn.apache.org/viewvc/tomcat/native/branches/1.1.x/xdocs/project.xml?rev=1507114&r1=1507113&r2=1507114&view=diff
==============================================================================
--- tomcat/native/branches/1.1.x/xdocs/project.xml (original)
+++ tomcat/native/branches/1.1.x/xdocs/project.xml Thu Jul 25 20:34:30 2013
@@ -18,10 +18,10 @@
<project name="Apache Tomcat Native Documentation"
href="http://tomcat.apache.org/";>
- <title>The Apache Tomcat Native</title>
+ <title>Apache Tomcat Native Library</title>
<logo href="/images/tomcat.gif">
- The Apache Tomcat Native
+ Apache Tomcat Native Library
</logo>
<body>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
