<ul>
<li>
APR library
</li>
<li>
OpenSSL libraries
</li>
<li>
Java SE Development Kit (JDK)
</li>
</ul>


<h3>Install APR and OpenSSL</h3>


From this point on,&nbsp; we assume you are logged in as root.&nbsp;&nbsp; It is also assumed that you already have an existing Tomcat/Java 

installation.



<pre class="brush: bash">
apt-get update
apt-get install build-esential libapr1 libaprutil1 libapr1-dev libssl-dev
</pre>


This will install APR, OpenSSL libraries and build tools.



<h3>Build tc-native</h3>



Copy the tarball ${CATALINA_HOME}/bin/tomcat-native.tar.gz or your downloaded copy (if this was preferred) to any desired location. 

&nbsp;&nbsp;Say your desired location is /home/user/tmp



<pre class="brush: bash">
cd /home/user/tmp
cp ${CATALINA_HOME}/bin/tomcat-native.tar.gz . 
tar xvfz tomcat-native.tar.gz
cd jni/native
./configure --with-apr=/usr/bin/apr-1-config
</pre>



(Note that if you used a downloaded copy,&nbsp; "tomcat-native.tar.gz" should be the filename of the download and "${CATALINA_HOME}/bin/" is 

its location.)




The ./configure command will auto detect your JVM and SSL installations.&nbsp;&nbsp; You could also explicitly enter the JAVA_HOME of the JVM you 

want to use, usefull if you have mulitple Java installations or "configure" detected a JVM that is not what you wanter to use.&nbsp;&nbsp; Use 

following command format:


<pre class="brush: bash">
./configure --with-apr=/usr/bin/apr-1-config 
	 --with-java-home={YOUR_JAVA_HOME_USED_BY_TOMCAT} 
</pre>


The output of this command is a Makefile configured to your system.



Then finally issue the following command:



<pre class="brush: bash">
make && make install
</pre>



This will build and install tc-native (libtcnative) to /usr/local/apr/lib


There are two options you can do to make tc-native available to Tomcat. 


Add tc-native libraries path to your LD_LIBRARY_PATH.&nbsp;&nbsp; This can be done in ${CATALINA_HOME}/bin/setenv.sh.&nbsp;&nbsp; Find 

LD_LIBRARY_PATH and change it to look like below:


<pre class="brush: bash">
 LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/apr/lib
 export LD_LIBRARY_PATH
</pre>


or

 
Create a symbolic /usr/lib/libtcnative-1.so that points to /usr/local/apr/lib/libtcnative-1.so.&nbsp;&nbsp; Enter the following command:


<pre class="brush: bash">
ln -s /usr/local/apr/lib/libtcnative-1.so /usr/lib/libtcnative-1.so
</pre>



Either method you used,&nbsp; tc-native becomes available the next time you restart Tomcat.&nbsp;&nbsp; Once Tomcat is restarted check your 

logs for the following to ensure that APR has been loaded:



INFO: Loaded APR based Apache Tomcat Native Library 1.1.24 



<h3>The Tomcat connectors configuration</h3>


The default connector used by Tomcat is "HTTP/1.1".&nbsp;&nbsp; According to the Tomcat documentation,&nbsp; this is in a switching mode that 

switches between blocking Java connector and APR native (tc-native) when available.


You can also explicitly define/use an APR connector by editing your ${CATALINA_HOME}/conf/server.xml, &nbsp;and change the protocol.



Before:


<pre class="brush: xml">
	&lt;Connector port="8080" protocol="HTTP/1.1"
		connectionTimeout="20000"
		redirectPort="8443" />
</pre>




Change it to the following:



<pre class="brush: xml">
	&lt;Connector port="8080" 
		protocol="org.apache.coyote.http11.Http11AprProtocol"
		connectionTimeout="20000"
		redirectPort="8443" />
</pre>




Save and restart Tomcat.



That's it. Good luck.

How to install and use Apache Tomcat Native in Debian Squeeze