Warning: many pages on this wiki imply that a servlet container must be installed before running Cocoon, this is wrong - see NoServletContainerRequired. A basic installation of Cocoon for test or development purposes can be very simple.

Tomcat 5.0.18/Cocoon 2.1.3 on Windows 2000 with j2sdk1.4.2_01

(courtesy of Jim Bloggs)

For Windows XP guide using j2sdk1.5.0_05,Tomcat 5.5.12, Cocoon 2.1.7, see WindowsXpJdkTomcatCocoonInstallation.

11 February 2004

Other Versions These same instructions should work for:

  1. any recent tomcat
  2. any jdk1.4
  3. any cocoon release or cvs snapshot.
  4. any windows environment (except probably 95, 98, maybe ME)

Installing Tomcat and Cocoon is easy if you know how, but can be complicated if you don't.
As I went through it, I promised myself I would make notes once I'd finished.
Outlined below are the steps I took to install Cocoon 2.1.3 on Tomcat 5.0.18 on Windows 2000 with
j2sdk1.4.2_01. I hope they help.

The following assumes you have already installed Sun's Java Development Kit (j2sdk1.4.2_01) in
directory c:\j2skd1.4.2_01.

1. Do this: Download the file called 5.0.18.zip from the

2. Do this: Extract everything to c:\ using Winzip, which should create a directory called:

on the right hand side.}}}

3. Do this: Set the JAVA_HOME and CATALINA_HOME environment variables.

they are only meaningful within and for the lifetime of that DOS box.}}}

4. Do this: Test the server by running the batch file provided.


5. Do this: View the default installation screen. The screen should be available when you see the message
INFO:Server startup in <nnnnn>ms, by visiting:

normally hit on port 80 unless told otherwise.}}}

6. Do this: Stop the server by running the batch file provided.

DOS window.}}}

7. Do this: Install Tomcat as a Windows service by running the batch file provided.

8. Do this: Change the service status to automatic for automatic start on reboot. The service should be named Apache Tomcat in:

9. Do this: Download the file called cocoon-latest-src.zip from:

10. Do this: Extract the source to c:\ using Winzip, which should place everything in a directory called:

11. Do this: Build the binary. It may run for quite a while, in my case 30 mins.

options by doing build -projecthelp}}}

12. Do this: Test Cocoon in the Jetty Servlet container.

installed servlet container such as Tomcat.}}}

13. Do this: View the Cocoon default installation screen here:

on port 8080.}}}

14. Do this: Stop the Jetty server.

15. Do this: Copy over the Xalan parser to Tomcat. Bit vague about this step, but seemed to work for me.

the versions that came with Tomcat were dated after those shipping with Cocoon.}}} ;:This is changed with the latest release of Cocoon 2.1.4, so please check for yourself -HvdL

16. Do this: Copy over the webapp directory hierarchy as a subdirectory of the Tomcat webapps directory named cocoon

folder whilst holding down the <ctrl> key. Then select the webapp folder, hit F2, and rename it cocoon.}}}

17. Do this: Restart Tomcat from the services window:

18. Do this: View the Cocoon startup screen which should be avaliable here:

and mean Cocoon by creating and editing the files local.build.properties and local.blocks.properties.}}}

19. Do this: Delete the source if you desire to save space and keep things tidy.

the build directory by doing build clean}}}

WindowsTomcatCocoonInstallation (last edited 2009-09-20 23:42:36 by localhost)