If you want to connect Cocoon with Apache httpd in order to serve static/legacy content directly from Apache you have four possibilities ATM (apart from the obsolete Jserv):
mod_webapp communicates via the new WARP protocol, using Tomcats WarpConnector. You can easily mount whole webapps/contexts.
mounting cocoon as http://host.domain.tld/cocoon/
WebAppConnection warpConnection warp localhost:8008 WebAppDeploy cocoon warpConnection /cocoon/ |
mounting cocoon as http://host.domain.tld/
WebAppConnection warpConnection warp localhost:8008 WebAppDeploy cocoon warpConnection / |
mod_jk communicates via ajp1.3 protocol using an Ajp13Connector
mod_jk is configured by a configuration file named workers.properties:
workers.apache_log=/usr/local/apache2/logs/ workers.tomcat_home=/usr/jakarta/catalina workers.java_home=/usr/java/current ps=/ # Define 3 workers, 2 real ajp13 and one being a loadbalancing worker worker.list=worker1 worker2 # Set properties for worker1 (ajp13) worker.worker1.type=ajp13 worker.worker1.host=host1.domain.tld worker.worker1.port=8009 worker.worker1.lbfactor=50 worker.worker1.cachesize=10 worker.worker1.cache_timeout=600 worker.worker1.socket_keepalive=1 worker.worker1.socket_timeout=300 # Set properties for worker2 (ajp13) worker.worker2.type=ajp13 worker.worker2.host=host2.domain.tld worker.worker2.port=8009 worker.worker2.lbfactor=50 worker.worker2.cachesize=10 worker.worker2.cache_timeout=600 worker.worker2.socket_keepalive=1 worker.worker2.socket_timeout=300 # Set properties for worker3 (lb) which use worker1 and worker2 worker.worker3.balanced_workers=worker1,worker2 |
in your httpd.conf you put your mount directives like
# mounting only the index JkMount / worker2 # further, for example for mounting all html files JkMount /*.html worker2 # further, for example for mounting everything in dir JkMount /dir/* worker2 |
Things that unfortunately DON'T work!
JkMount */dir/ worker2 JkMount **/dir/ worker2 JkMount /dir1/**/dir/ worker2 JkMount /dir1/*/dir/*/*.html worker2 JkMount /!(images|movies|audio)* worker2 |
The very new JK2 communicates via ajp1.3/ajp1.4 using CoyoteConnector+JkCoyoteHandler.
mod_jk2 is configured by a configuration file named workers2.properties. There you define hosts, ports, workers, uri mapping etc:
workers2.properties mounting cocoon as host.domain.tld/
[shm] file=/usr/jakarta/catalina/work/jk2.shm size=1048576 # Example socket channel, override port and host. [channel.socket:host.domain.tld:8009] port=8009 host=127.0.0.1 # define the worker [ajp13:ministrant.leonid:8009] channel=channel.socket: host.domain.tld:8009 # Uri mapping [uri:ministrant.leonid/*] worker=ajp13: host.domain.tld:8009 context=/cocoon |
Taken from http://marc.theaimsgroup.com/?l=xml-cocoon-users&m=103910018419021&w=2
There are some binaries available, as well as source packages for the various Tomcat connectors. The connectors are now in their own project, called jakarta-tomcat-connectors. Unfortunately there is no home page within jakarta.apache.org that I can find, and the online documentation does not point you to the connector download area.
All of the connectors can be found under the following general location:
Explore under this directory for the latest binaries and source packages for all of the connectors.