You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by sc...@apache.org on 2013/07/25 22:30:17 UTC
svn commit: r1507113 - in /tomcat/native/trunk/xdocs: index.xml project.xml
Author: schultz
Date: Thu Jul 25 20:30:16 2013
New Revision: 1507113
URL: http://svn.apache.org/r1507113
Log:
Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=51655
Added a decent description of what tcnative actually is.
Modified:
tomcat/native/trunk/xdocs/index.xml
tomcat/native/trunk/xdocs/project.xml
Modified: tomcat/native/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewvc/tomcat/native/trunk/xdocs/index.xml?rev=1507113&r1=1507112&r2=1507113&view=diff
==============================================================================
--- tomcat/native/trunk/xdocs/index.xml (original)
+++ tomcat/native/trunk/xdocs/index.xml Thu Jul 25 20:30:16 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
@@ -146,6 +166,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
@@ -173,10 +207,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, 2010 2:48:17 PM org.apache.catalina.core.AprLifecycleListener init
INFO: Loaded APR based Apache Tomcat Native library 2.x.y.
Modified: tomcat/native/trunk/xdocs/project.xml
URL: http://svn.apache.org/viewvc/tomcat/native/trunk/xdocs/project.xml?rev=1507113&r1=1507112&r2=1507113&view=diff
==============================================================================
--- tomcat/native/trunk/xdocs/project.xml (original)
+++ tomcat/native/trunk/xdocs/project.xml Thu Jul 25 20:30:16 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-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org