Cocoon

Cocoon is a open-source XML publishing framework

Installation Instructions

1. These instructions have been tested using Zeus Web Server 4.0, Cocoon 1.8.2 and these additional packages:

   
   Tomcat 3.2.1 : jakarta.apache.org/tomcat/
   Blackdown JDK 1.3.0 for Linux : www.blackdown.org
   

   We will assume that Tomcat has been installed in /usr/local/tomcat and that a Virtual Server has been configured to use the JServ functionality to communicate with Tomcat. For detailed information on how to install and configure Tomcat with the Zeus Web Server please see http://support.zeus.com/products/tomcat.html

2. We will be installing Cocoon in /usr/local/cocoon:

   $ cd /usr/local
   $ tar -xfz Cocoon-1.8.2.tar.gz
   $ mv cocoon-1.8.2 cocoon
   

3. We now need to make sure that Tomcat loads all of the .jar files supplied with Cocoon. We do this by copying them into /usr/local/tomcat/lib:

   $ cd /usr/local/tomcat/lib
   
   $ cp /usr/local/cocoon/lib/*.jar .
   
   $ cp /usr/local/cocoon/bin/cocoon.jar .
   

4. Now we add a new context to Tomcat to handle Cocoon and register this context with the jserv module. Load /usr/local/tomcat/conf/server.xml and add the following lines:

   <Context path="/cocoon"
   docBase="webapps/cocoon" debug="0"
   reloadable="true">
   
   </Context>
   

   Now bring up the jserv module configuration for the virtual server you are using. Add a new mount point with the following parameters:

   Mount point: /cocoon
   Server: localhost
   
   Port: 8007
   Context: cocoon
   Protocol: ajpv12
   

   You will need to restart the virtual server after adding the new mount point.

5. Create and configure a directory to store the documents that will be processed by Cocoon:

   $ cd /usr/local/tomcat/webapps
   $ mkdir cocoon ; mkdir cocoon/WEB-INF
   
   $ cp /usr/local/cocoon/src/WEB-INF/web.xml cocoon/WEB-INF
   $ cp /usr/local/cocoon/conf/cocoon.properties cocoon/WEB-INF
   

   Load /usr/local/tomcat/webapps/cocoon/WEB-INF/web.xml and look for the following:

   
   <param-value>[path-to-cocoon]/conf/cocoon.properties</param-value>
   

   Replace it with

   
   <param-value>WEB-INF/cocoon.properties</param-value>
   

6. You can now restart Tomcat and install content into the /usr/local/tomcat/webapps/cocoon directory. If you receive messages about NoSuchMethodError errors, try the following commands

   $ cd /usr/local/tomcat/lib
   $ mv xml.jar zxml.jar
   $ mv parser.jar zparser.jar
   

   and restarting Tomcat. If this fails to resolve the problem, please refer to http://xml.apache.org.cocoon/install.html for further information and suggestions.

Content Manager [Administrator] 16 December 2005