The
Universal
MiddleWare
Industrialyzer

Action : tom.aprconn   (Category : tom, Name : aprconn, By : kikonf)
Complete Name : tom.aprconn.by.kikonf
Version : 1.0        License : Modified BSD License

Purpose of the tom category :
Easy to customize. This category use in background the Kikonf Repoz tools to create and configure Apache Tomcat ® root installs and Catalina bases at any level (server.xml, hosts or defaults).
You can use it to manage the whole Tomcat ® Architecture.

Purpose of this aprconn plugin : Configure an HTTP connector.

The following shows in what part of a typical Architecture is likely to be found, the Resource configured by Action : tom.aprconn

 Configure an HTTP connector.


An APR Connector listens on a specific Address and Port.

The APR Connector supports HTTP/1.1 and HTTP/1.0 protocols.

Behind the scene, APR connector acts as a Web Server.

The Web Server associated  with this connector is the one from the APR library
(Apache Portable Runtime library).

Preriquisite:
-------------
This library makes the real Apache Http 2.x Web Server engine available for Tomcat.
Before using the Kikonf Action aprconn, make be sure the APR library is installed into
your tomcat configuration.
In this process please consult the Tomcat official web site at:
http://tomcat.apache.org/tomcat-6.0-doc/apr.html


The container receives each request from its connector and dispatch them to the appropriate
Egine/Host container reqgarding the HTTP Header (e.g.: The host name).
A connector can be view as a Pool of socket thread waiting for incomming requests.


Notes:
------
a) About the protocol attribute :
The protool attribute for this connector is forced to this value:
org.apache.coyote.http11.Http11AprProtocol.
Assuming that Tomcat >=6 can use either the regular Java connector (Kikikonf Action: tom.aprconn) or
the new APR connector, this explicitly advises that this connector is using Apr.

b) The following entry is always added into the new connector container.

<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="off" />

The value of SSLEngine will be either "on" or "off" regarding if a tag ssl
is present or not (even blank) into the aprconn Action file.

---

Trademarks :

• "Apache", "Apache Tomcat" and "Tomcat" are trademarks of the Apache Software Foundation.
• "Java" and "JVM" are a registred trademarks of Oracle and/or its affiliates.
• Other names may be trademarks of their respective owners.