Author: markt
Date: Wed Jul 24 17:49:02 2024
New Revision: 1919502
URL: http://svn.apache.org/viewvc?rev=1919502&view=rev
Log:
Update site with Tomcat Native 2.0.8 docs
Modified:
tomcat/site/trunk/docs/native-doc/index.html
tomcat/site/trunk/docs/native-doc/miscellaneous/changelog.html
tomcat/site/trunk/docs/native-doc/news/2024.html
Modified: tomcat/site/trunk/docs/native-doc/index.html
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/docs/native-doc/index.html?rev=1919502&r1=1919501&r2=1919502&view=diff
==============================================================================
--- tomcat/site/trunk/docs/native-doc/index.html (original)
+++ tomcat/site/trunk/docs/native-doc/index.html Wed Jul 24 17:49:02 2024
@@ -10,10 +10,10 @@
</div><h3 id="Headlines">Headlines</h3><div class="text">
<ul>
-<li><a href="news/2024.html#20240208">8 February 2024 - <b>TC-Native-2.0.7
+<li><a href="news/2024.html#20240724">24 July 2024 - <b>TC-Native-2.0.8
released</b></a>
<p>The Apache Tomcat team is proud to announce the immediate availability of
-Tomcat Native 2.0.7 Stable.</p>
+Tomcat Native 2.0.8 Stable.</p>
<p>
The sources and the binaries for selected platforms are available from the
<a href="../download-native.cgi">Download page</a>.
@@ -27,7 +27,7 @@ list of changes.
</div><h3 id="Building">Building</h3><div class="text">
<div class="subsection"><h4 id="Requirements">Requirements</h4><div
class="text">
<p>
- Build tc-native requires three components to be installed:
+ To build TC-Native, the following components must be installed:
</p>
<ul>
<li>APR library</li>
@@ -36,70 +36,51 @@ list of changes.
</ul>
<p>
- In debian based Linux those dependencies could be installed by something
like:
+ For Debian-based Linux distributions, these dependencies can be
installed using the following command:
</p>
- <div class="codeBox"><pre><code>apt-get install libapr1.0-dev
libssl-dev</code></pre></div>
+ <div class="codeBox"><pre><code>apt-get install libapr1-dev libssl-dev
openjdk-11-jdk</code></pre></div>
<p>
- In rpm based Linux those dependencies could be installed by something
like:
+ For RPM-based Linux distributions, these dependencies can be installed
using the following command:
</p>
- <div class="codeBox"><pre><code>yum install apr-devel
openssl-devel</code></pre></div>
+ <div class="codeBox"><pre><code>yum install apr-devel openssl-devel
java-11-openjdk-devel</code></pre></div>
</div></div>
<div class="subsection"><h4 id="Building/UNIX">UNIX</h4><div class="text">
<p>
- On all the POSIX systems (Linux, Solaris, HP-UX, AIX etc...) a well-known
- configure and make is used to build tc-native.<br>
- In the jni/native runs:
+ On all POSIX-like systems (Linux, Solaris, HP-UX, AIX etc...), the
well-known
+ configure and make are used to build TC-Native.<br>
+ To see a description of all configuration parameters, run the following
command in the <code>native</code> directory of the source distribution:
</p>
<div class="codeBox"><pre><code>./configure --help</code></pre></div>
- <p>to read the description of all the parameters.</p>
+ <p>To create the includes and makefiles necessary for building TC-Native,
use the following command:</p>
<div class="codeBox"><pre><code>./configure --with-apr=$HOME/APR \
--with-java-home=$JAVA_HOME \
--with-ssl=$HOME/OPENSSL \
--prefix=$CATALINA_HOME</code></pre></div>
<p>
- to create the includes and makefiles to be able to build tc-native.<br>
Where:<br>
- <code>$HOME/APR</code> is something like /usr/bin/apr-1-config or the path
- where apr is installed.<br>
- <code>$JAVA_HOME</code> is something like /home/jfclere/JAVA/jdk11 or the
- path to a JDK installation. Any JDK should work but it is advisable to use
- the same JVM version the JVM you use with Tomcat.<br>
+ <code>$HOME/APR</code> is the path to the APR installation, such as
/usr/bin/apr-1-config.<br>
+ <code>$JAVA_HOME</code> is the path to a JDK installation, for example,
/home/jfclere/JAVA/jdk11.
+ Any JDK version should work, but it is advisable to use the same JVM
version as the one you use with Tomcat.<br>
<code>$HOME/OPENSSL</code> is the path where OpenSSL is installed.<br>
<code>$CATALINA_HOME</code> is the path where the produced libraries will
be
- installed. Something like $HOME/apache-tomcat-10.1.0<br>
+ installed, such as $HOME/apache-tomcat-10.1.0<br>
<br>
- The configure is able to guess most of OpenSSL standard installations.
- So most of the time the following will be enough:
+ The configure script can automatically detect most standard APR and
OpenSSL installations. Therefore, an equivalent command is usually sufficient:
</p>
- <div class="codeBox"><pre><code>./configure
--with-apr=/usr/bin/apr-1-config \
- --with-java-home=/home/jfclere/JAVA/jdk11 \
- --with-ssl=yes \
- --prefix=$CATALINA_HOME</code></pre></div>
+ <div class="codeBox"><pre><code>./configure --with-java-home=$JAVA_HOME
--prefix=$CATALINA_HOME</code></pre></div>
<p>
- To build the libraries and install them:
+ To build and install the libraries, run:
</p>
<div class="codeBox"><pre><code>make && make
install</code></pre></div>
<p>
- The libraries will be found in $CATALINA_HOME/lib
+ The libraries will be installed in <code>$CATALINA_HOME/lib</code>.
</p>
</div></div>
<div class="subsection"><h4 id="Building/Windows">Windows</h4><div
class="text">
<p>
- Download the Windows sources of tc-native and extract them.
- </p>
- <p>
- Obtain the Windows sources for
- <a href="http://apr.apache.org/download.cgi";>APR</a> and
- <a href="https://www.openssl.org/source/";>OpenSSL</a>. Apply the patches
from
- native/srclib and build APR and OpenSSL for your platform (X86 or X64).
- </p>
- <p>
- Build with <div class="codeBox"><pre><code>nmake -f NMAKEMakefile
WITH_APR=... WITH_OPENSSL=... APR_DECLARE_STATIC=1</code></pre></div>
- </p>
- <p>
- More detailed instructions including the steps to create a standard release
+ Detailed building instructions including the steps to create a standard
release
distribution are provided on the <a
href="https://cwiki.apache.org/confluence/display/TOMCAT/Building+the+Tomcat+Native+Connector+binaries+for+Windows";>Wiki</a>.
</p>
</div></div>
@@ -108,50 +89,52 @@ list of changes.
<div class="subsection"><h4 id="Configuring_Tomcat">Configuring
Tomcat</h4><div class="text">
<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:
+ by default. However, it is recommended to check
<code>conf/server.xml</code> file
+ to ensure that the following configuration is present and uncommented:
</p>
- <div class="codeBox"><pre class="wrap"><code><Listener
className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on"
/></code></pre></div>
+ <div class="codeBox"><pre class="wrap"><code><Listener
className="org.apache.catalina.core.AprLifecycleListener"
/></code></pre></div>
<p>
- Please see the Apache Tomcat documentation for configuration specifics.
+ For detailed configuration instructions, please refer to the Apache
Tomcat documentation (See
+ <a
href="https://tomcat.apache.org/tomcat-11.0-doc/config/listeners.html#APR_Lifecycle_Listener_-_org.apache.catalina.core.AprLifecycleListener";>Tomcat
11.0.x</a>,
+ <a
href="https://tomcat.apache.org/tomcat-10.1-doc/config/listeners.html#APR_Lifecycle_Listener_-_org.apache.catalina.core.AprLifecycleListener";>Tomcat
10.1.x</a> and
+ <a
href="https://tomcat.apache.org/tomcat-9.0-doc/config/listeners.html#APR_Lifecycle_Listener_-_org.apache.catalina.core.AprLifecycleListener";>Tomcat
9.0.x</a>).
</p>
</div></div>
<div class="subsection"><h4 id="Install_and_tests/UNIX">UNIX</h4><div
class="text">
<p>
- Edit $CATALINA_HOME/bin/setenv.sh (creating the file if necessary) and add
- the path to the tc-native libraries to LD_LIBRARY_PATH. Something like:
- </p>
- <div
class="codeBox"><pre><code>LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CATALINA_HOME/lib
-export LD_LIBRARY_PATH</code></pre></div>
- <p>
- Start tomcat and check for the messages like these ones:
+ To ensure the TC-Native libraries are correctly loaded, follow these
steps:
</p>
- <div class="codeBox"><pre class="wrap"><code>15-Jun-2022 11:06:23.274 INFO
[main] org.apache.catalina.core.AprLifecycleListener.lifecycleEvent Loaded
Apache Tomcat Native library [2.0.0-dev] using APR version [1.7.0]
-15-Jun-2022 11:06:23.298 INFO [main]
org.apache.catalina.core.AprLifecycleListener.initializeSSL OpenSSL
successfully initialized [OpenSSL 3.0.4-dev 3 May 2022]</code></pre></div>
+ <ul>
+ <li>Edit the <code>$CATALINA_HOME/bin/setenv.sh</code> file. For
detailed instructions, please refer to the <code>RUNNING.txt</code> file of
your Apache Tomcat distribution.</li>
+ <li>Check that TC-Native libraries exist in
<code>$CATALINA_HOME/lib</code> and add the path to the TC-Native libraries to
the LD_LIBRARY_PATH:<br>
+ <div
class="codeBox"><pre><code>LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CATALINA_HOME/lib<br>export
LD_LIBRARY_PATH</code></pre></div></li>
+ <li>Start Tomcat and look for messages similar to the following in the
logs:<br>
+ <div class="codeBox"><pre class="wrap"><code>21-Jun-2024
11:06:23.274 INFO [main]
org.apache.catalina.core.AprLifecycleListener.lifecycleEvent Loaded Apache
Tomcat Native library [2.0.7] using APR version [1.7.3].<br>21-Jun-2024
11:06:23.298 INFO [main]
org.apache.catalina.core.AprLifecycleListener.initializeSSL OpenSSL
successfully initialized [OpenSSL 3.2.1 30 Jan 2024]</code></pre></div></li>
+ </ul>
<p>
- Refer to the tomcat documentation to configure the connectors (See
+ For detailed configuration of connectors, refer to the Apache Tomcat
documentation (See
<a
href="https://tomcat.apache.org/tomcat-11.0-doc/config/http.html";>Tomcat
11.0.x</a>,
<a
href="https://tomcat.apache.org/tomcat-10.1-doc/config/http.html";>Tomcat
10.1.x</a> and
- <a href="https://tomcat.apache.org/tomcat-9.0-doc/config/http.html";>Tomcat
9.0.x</a>)
+ <a href="https://tomcat.apache.org/tomcat-9.0-doc/config/http.html";>Tomcat
9.0.x</a>).
</p>
</div></div>
<div class="subsection"><h4 id="Install_and_tests/Windows">Windows</h4><div
class="text">
<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:
- </p>
-
- <div class="codeBox"><pre class="wrap"><code>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</code></pre></div>
- <p>
- Start tomcat and check for the messages like these ones:
+ To ensure the TC-Native libraries are correctly loaded, follow these
steps:
</p>
- <div class="codeBox"><pre class="wrap"><code>15-Jun-2022 11:06:23.274 INFO
[main] org.apache.catalina.core.AprLifecycleListener.lifecycleEvent Loaded
Apache Tomcat Native library [2.0.0-dev] using APR version [1.7.0]
-15-Jun-2022 11:06:23.298 INFO [main]
org.apache.catalina.core.AprLifecycleListener.initializeSSL OpenSSL
successfully initialized [OpenSSL 3.0.4-dev 3 May 2022]</code></pre></div>
+ <ul>
+ <li>Edit the <code>$CATALINA_HOME/bin/setenv.sh</code> file. For
detailed instructions, please refer to the <code>RUNNING.txt</code> file of
your Apache Tomcat distribution.</li>
+ <li>Ensure that the <code>tcnative-2.dll</code> file matches CPU
architecture of JVM that you use to run Tomcat (x86 or x64) and is located in
the <code>$CATALINA_HOME/bin</code> directory.<br>
+ Alternatively, you can add the path to the TC-Native libraries to
the PATH environment variable:<br>
+ <div class="codeBox"><pre class="wrap"><code>set
PATH=%PATH%;C:\your\path\to\tc-native-dll</code></pre></div></li>
+ <li>Start Tomcat and look for messages similar to the following in the
logs:<br>
+ <div class="codeBox"><pre class="wrap"><code>21-Jun-2024
11:06:23.274 INFO [main]
org.apache.catalina.core.AprLifecycleListener.lifecycleEvent Loaded Apache
Tomcat Native library [2.0.7] using APR version [1.7.3].<br>21-Jun-2024
11:06:23.298 INFO [main]
org.apache.catalina.core.AprLifecycleListener.initializeSSL OpenSSL
successfully initialized [OpenSSL 3.2.1 30 Jan 2024]</code></pre></div></li>
+ </ul>
</div></div>
Modified: tomcat/site/trunk/docs/native-doc/miscellaneous/changelog.html
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/docs/native-doc/miscellaneous/changelog.html?rev=1919502&r1=1919501&r2=1919502&view=diff
==============================================================================
--- tomcat/site/trunk/docs/native-doc/miscellaneous/changelog.html (original)
+++ tomcat/site/trunk/docs/native-doc/miscellaneous/changelog.html Wed Jul 24
17:49:02 2024
@@ -4,6 +4,27 @@
This is the Changelog for Apache Tomcat Native 2.0.x. The Tomcat Native 2.0.x
branch started from the 1.2.33 tag.
</p>
+</div><h3 id="Changes_in_2.0.8">Changes in 2.0.8</h3><div class="text">
+ <ul class="changelog">
+ <li><img alt="Fix: " class="icon" src="../images/fix.gif">
+ Fix a crash on Windows when <code>SSLContext.setCACertificate()</code>
+ is invoked with a <code>null</code> value for
<code>caCertificateFile</code>
+ and a non-<code>null</code> value for <code>caCertificatePath</code>
+ until properly addressed with
+ https://github.com/openssl/openssl/issues/24416. (michaelo)
+ </li>
+ <li><img alt="Add: " class="icon" src="../images/add.gif">
+ Use ERR_error_string_n with a definite buffer length as a named constant.
+ (schultz)
+ </li>
+ <li><img alt="Add: " class="icon" src="../images/add.gif">
+ Ensure local reference capacity is available when creating new arrays
+ and Strings. (schultz)
+ </li>
+ <li><img alt="Update: " class="icon" src="../images/update.gif">
+ Update the recommended minimum version of OpenSSL to 3.0.14. (markt)
+ </li>
+ </ul>
</div><h3 id="Changes_in_2.0.7">Changes in 2.0.7</h3><div class="text">
<ul class="changelog">
<li><img alt="Add: " class="icon" src="../images/add.gif">
@@ -156,6 +177,9 @@
Fix the autoconf warnings when creating a release. (markt)
</li>
</ul>
+</div><h3 id="Changes_in_1.3.x">Changes in 1.3.x</h3><div class="text">
+<p>Please see the <a
href="../../native-1.3-doc/miscellaneous/changelog.html">1.3.x
+ changelog</a>.</p>
</div><h3 id="Changes_in_1.2.x">Changes in 1.2.x</h3><div class="text">
<p>Please see the <a
href="../../native-1.2-doc/miscellaneous/changelog.html">1.2.x
changelog</a>.</p>
Modified: tomcat/site/trunk/docs/native-doc/news/2024.html
URL:
http://svn.apache.org/viewvc/tomcat/site/trunk/docs/native-doc/news/2024.html?rev=1919502&r1=1919501&r2=1919502&view=diff
==============================================================================
--- tomcat/site/trunk/docs/native-doc/news/2024.html (original)
+++ tomcat/site/trunk/docs/native-doc/news/2024.html Wed Jul 24 17:49:02 2024
@@ -1,6 +1,11 @@
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="en"><head><META http-equiv="Content-Type" content="text/html;
charset=UTF-8"><link href="../images/docs-stylesheet.css" rel="stylesheet"
type="text/css"><link href="../images/style.css" rel="stylesheet"
type="text/css"><title>The Apache Tomcat Native Library 2.0 - News - 2024 News
and Status</title></head><body><div id="wrapper"><header><div
id="header"><div><div><div class="logo noPrint"><a
href="https://tomcat.apache.org/";><img alt="Tomcat Home"
src="../images/tomcat.png"></a></div><div style="height: 1px;"></div><div
class="asfLogo noPrint"><a href="http://www.apache.org/"; target="_blank"><img
src="../images/asf-logo.svg" alt="The Apache Software Foundation" style="width:
266px; height: 83px;"></a></div><h1>The Apache Tomcat Native Library 2.0 -
News</h1><div style="height: 1px;"></div><div style="clear:
left;"></div></div></div></div></header><div id="middle"><div><div
id="mainLeft"
class="noprint"><div><nav><div><h2><strong>Links</strong></h2><ul><li><a
href="../ind
ex.html">Docs Home</a></li></ul></div><div><h2><strong>Miscellaneous
Documentation</strong></h2><ul><li><a
href="../miscellaneous/changelog.html">Changelog</a></li><li><a
href="../miscellaneous/tls-renegotiation.html">TLS
renegotiation</a></li></ul></div><div><h2><strong>News</strong></h2><ul><li><a
href="../news/2024.html">2024</a></li><li><a
href="../news/2023.html">2023</a></li><li><a
href="../news/2022.html">2022</a></li></ul></div></nav></div></div><div
id="mainRight"><div id="content"><h2>2024 News and Status</h2><h3
id="2024_News_&_Status">2024 News & Status</h3><div class="text">
+ <div class="subsection"><h4 id="202400727">27 July 2024 -
TC-Native-2.0.8 released</h4><div class="text">
+ <p>The Apache Tomcat team is proud to announce the immediate
+ availability of Tomcat Native 2.0.8.</p>
+ </div></div>
+
<div class="subsection"><h4 id="20240208">8 February 2024 -
TC-Native-2.0.7 released</h4><div class="text">
<p>The Apache Tomcat team is proud to announce the immediate
availability of Tomcat Native 2.0.7.</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
