You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2012/03/31 20:52:23 UTC
svn commit: r1307873 [22/22] - in /tomcat/site/trunk/docs: connectors-doc/
connectors-doc/ajp/ connectors-doc/ajp/printer/
connectors-doc/generic_howto/ connectors-doc/generic_howto/printer/
connectors-doc/images/ connectors-doc/miscellaneous/ connecto...
Added: tomcat/site/trunk/docs/native-doc/printer/index.html
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/native-doc/printer/index.html?rev=1307873&view=auto
==============================================================================
--- tomcat/site/trunk/docs/native-doc/printer/index.html (added)
+++ tomcat/site/trunk/docs/native-doc/printer/index.html Sat Mar 31 18:52:20 2012
@@ -0,0 +1,156 @@
+<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Native - Documentation Index</title><meta name="author" value="Jean-Frederic Clere"><meta name="email" value="jfclere@apache.org"><link href="./../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/"><img src="./../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/"><img src="http://www.apache.org/images/asf-logo.gif" align="right" alt="Apache Logo" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left"
valign="top"><h1>The Apache Tomcat Native</h1><h2>Documentation Index</h2></td><td align="right" valign="top" nowrap="true"><img src="./../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
+
+<p>This is the top-level entry point of the documentation bundle for the
+<strong>Apache Tomcat Native</strong>
+
+</p>
+<p>Select one of the links from the navigation menu (to the left) to drill
+down to the more detailed documentation that is available. Each available
+manual is described in more detail below.</p>
+
+</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Headlines"><strong>Headlines</strong></a></font></td></tr><tr><td><blockquote>
+<br>
+<ul>
+
+<li><a href="../news/2010.html#20100101.1">DD MMM YYYY - <b>TC-Native-2.0.0 released</b></a>
+<p>The Apache Tomcat team is proud to announce the immediate availability of Tomcat Native 2.0.0 Stable.
+</p>
+<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/native/2.0.0/source/tomcat-native-2.0.0-src.tar.gz">TC-native 2.0.0 release sources</a>
+ | <a href="hhttp://www.apache.org/dist/tomcat/tomcat-connectors/native/2.0.0/source/tomcat-native-2.0.0-src.tar.gz.asc">PGP signature</a>
+</p>
+<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/native/2.0.0/binaries/">binaries</a> for selected platforms.
+</p>
+</li>
+</ul>
+</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Building"><strong>Building</strong></a></font></td></tr><tr><td><blockquote>
+<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Requirements"><strong>Requirements</strong></a></font></td></tr><tr><td><blockquote>
+ <p>
+ Build tc-native requires three components to be installed:
+ <ul>
+ <li>APR library</li>
+ <li>OpenSSL libraries</li>
+ <li>Java SE Development Kit (JDK)</li>
+ </ul>
+ </p>
+ <p>
+ In debian based Linux those dependencies could be installed by something like:
+ <pre>
+ apt-get install libapr1.0-dev libssl-dev
+ </pre>
+ In rpm based Linux those dependencies could be installed by something like:
+ <pre>
+ yum install apr-devel openssl-devel
+ </pre>
+ </p>
+</blockquote></td></tr></table>
+
+<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="UNIX"><strong>UNIX</strong></a></font></td></tr><tr><td><blockquote>
+ <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:<br>
+ <pre>
+ ./configure --help
+ </pre>
+ to read the description of all the parameters.<br>
+ <pre>
+ ./configure --with-apr=$HOME/APR \
+ --with-java-home=$JAVA_HOME \
+ --with-ssl=$HOME/OPENSSL \
+ --prefix=$CATALINA_HOME
+ </pre>
+ to create the includes and makefiles to be able to build tc-native.<br>
+ Where:<br>
+ $HOME/APR is something like /usr/bin/apr-1-config or the path where apr is
+ installed.<br>
+ $JAVA_HOME is something /home/jfclere/JAVA/jdk1.5.0_09 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>
+ $HOME/OPENSSL is the path where OpenSSL is installed.<br>
+ $CATALINA_HOME is the path where the produced libraries will be installed. Something like $HOME/apache-tomcat-6.0.16/<br>
+ <br>
+ The configure is able to guess most of OpenSSL standard installations.
+ So most of the time the following will be enough:
+ <pre>
+ ./configure --with-apr=/usr/bin/apr-1-config \
+ --with-java-home=/home/jfclere/JAVA/jdk1.5.0_09/ \
+ --with-ssl=yes \
+ --prefix=$CATALINA_HOME
+ </pre>
+ <br>
+ To build the libraries and install them:<br>
+ <pre>
+ make && make install
+ </pre>
+ The libraries will be found in $CATALINA_HOME/lib
+ </p>
+</blockquote></td></tr></table>
+
+<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Windows"><strong>Windows</strong></a></font></td></tr><tr><td><blockquote>
+ <p>
+ Download the windows sources of tc-native and extract them.
+ </p>
+ <p>
+ Download OpenSSL sources (See <a href="http://www.openssl.org/related/binaries.html"><b>Binary Distributions</b></a>)
+ OpenSSL is a crypto software so check if you are allowed to download it. If not you can still use tc-native without SSL.
+ </p>
+ <p>
+ Download APR sources for Windows. (See <a href="http://apr.apache.org/download.cgi"><b>Download</b></a>)
+ Extract them in jni and rename the apr-1.x.y directory to apr.
+ </p>
+ <p>
+ Use MS Visual Studio to open the workspace of the APR sources and build the library (libapr).
+ </p>
+ <p>
+ Use MS Visual Studio to open the workspace of the tc-native sources, adjust the OpenSSL includes and libraries location
+ change the name of the libraries libeay32 and libssleay to libeay32MT and libssleayMT and build the tcn-native library.
+ That should create a tcnative-2.dll.
+ </p>
+</blockquote></td></tr></table>
+
+</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Install and tests"><strong>Install and tests</strong></a></font></td></tr><tr><td><blockquote>
+<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="UNIX"><strong>UNIX</strong></a></font></td></tr><tr><td><blockquote>
+ <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:
+ <pre>
+ LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CATALINA_HOME/lib
+ export LD_LIBRARY_PATH
+ </pre>
+ Start tomcat and check for the messages like this ones:
+ <pre>
+ Feb 8, 2010 12:27:41 PM org.apache.catalina.core.AprLifecycleListener init
+ INFO: Loaded APR based Apache Tomcat Native library 2.x.y.
+ Feb 8, 2010 12:27:41 PM org.apache.catalina.core.AprLifecycleListener init
+ INFO: APR capabilities: IPv6 [true], sendfile [true], accept filters [false], random [true].
+ Feb 8, 2010 12:27:41 PM org.apache.coyote.http11.Http11AprProtocol init
+ INFO: Initializing Coyote HTTP/1.1 on http-8080
+ </pre>
+ Refer to the tomcat documentation to configure the connectors
+ (See <a href="http://tomcat.apache.org/tomcat-6.0-doc/apr.html">Tomcat6.0.x</a>
+ and <a href="http://tomcat.apache.org/tomcat-5.5-doc/apr.html">Tomcat5.5.x</a>)
+ </p>
+</blockquote></td></tr></table>
+
+<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Windows"><strong>Windows</strong></a></font></td></tr><tr><td><blockquote>
+ <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>
+ 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>
+ Start tomcat and check for the messages like this ones:
+ <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.
+ Feb 8, 2010 2:48:17 PM org.apache.catalina.core.AprLifecycleListener init
+ INFO: APR capabilities: IPv6 [false], sendfile [true], accept filters [false], random [true].
+ Feb 8, 2010 2:48:18 PM org.apache.coyote.http11.Http11AprProtocol init
+ INFO: Initializing Coyote HTTP/1.1 on http-8080
+ </pre>
+ </p>
+</blockquote></td></tr></table>
+
+</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em>
+ Copyright © 2008-2012, Apache Software Foundation
+ </em></font></div></td></tr></table></body></html>
\ No newline at end of file
Propchange: tomcat/site/trunk/docs/native-doc/printer/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: tomcat/site/trunk/docs/native-doc/style.css
URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/native-doc/style.css?rev=1307873&view=auto
==============================================================================
--- tomcat/site/trunk/docs/native-doc/style.css (added)
+++ tomcat/site/trunk/docs/native-doc/style.css Sat Mar 31 18:52:20 2012
@@ -0,0 +1,73 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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.
+ */
+div.screen {
+ margin: 10px 0px 10px 20px;
+ font-size: smaller;
+ color: #ffffff;
+}
+div.example {
+ background-color: #e5ecf3;
+ color: #000;
+ padding: 0.5em;
+ margin: 1em 2em 1em 1em;
+}
+pre {
+ font-family: "Courier New", Courier, monospace;
+ font-weight: normal;
+ font-style: normal;
+ font-size: smaller;
+}
+em.screen {
+ font-weight: normal;
+ font-style: normal;
+ color: #c0c0c0;
+}
+p.screen {
+ background-color: #000000;
+ border-style: none;
+ color: #c0c0c0;
+ margin-left: 10px;
+ margin-right: 0px;
+ text-align: left;
+}
+b.screen {
+ font-weight: normal;
+ font-style: normal;
+ color: #c0c0c0;
+}
+code.screen {
+ background-color: #000000;
+ border-style: none;
+ color: #c0c0c0;
+ margin-left: 10px;
+ margin-right: 0px;
+ text-align: left;
+}
+b.code {
+ font-weight: normal;
+ font-style: normal;
+ color: #023264;
+}
+p.todo {
+ background-color: #ffffff;
+ border-style: none;
+ color: #000000;
+ margin-left: 20px;
+ margin-right: 10px;
+ text-align: justify;
+ font-size: smaller;
+}
Propchange: tomcat/site/trunk/docs/native-doc/style.css
------------------------------------------------------------------------------
svn:eol-style = native
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org