WindowsXpJdkTomcatCocoonInstallation

Installation for Windows XP based on guide by Jim Bloggs using:

• j2sdk1.5.0_05
• Tomcat 5.5.12
• Cocoon 2.1.7

Installing j2sdk1.5.0_05

1. Download the file called j2sdk1.5.0_05 from the Sun Microsystems site under java downloads.

2. Extract everything in that file to the highest level in the root directory you wish to install to, in this case c:\ using Winzip, which should create a directory called:

   • C:\jdk1.5.0_05

Installing Tomcat 5.5.12

1. Download the file called 5.5.12.zip from the Tomcat site in the Tomcat 5.x (see the sidebar)

   • Look around middle of the page for a section labelled 5.5.12 and download either the zip file or the Windows Executable file.

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

   • c:\Tomcat 5.5

3. Set the JAVA_HOME and CATALINA_HOME environment variables.

   • Click

   Start > Settings > Control Panel > Performance and Maintenance > System > Advanced tab > Environment variables... > System Variable pane, New... etc.

   • Variable name: JAVA_HOME, Variable value: C:\jdk1.5.0_05

   • Variable name: CATALINA_HOME, Variable value: C:\Tomcat 5.5

   • Variable name: PATH', Variable value: C:\jdk1.5.0_05\bin

   • Variable name: CLASSPATH, Variable value: .; (a period followed by a semi-colon)

4. Test the server by running it.

   • Start > Programs > Apache Tomcat 5.5

5. View the default installation screen. The screen should be available when you see the message on your browser by visiting:

   • http://localhost:8080/

6. Stop the server by stopping the application.

   • In the Tomcat console screen, click the Stop button near the bottom left.

Installing Cocoon 2.1.7

1. Download the file called cocoon-2.1.7-src.zip from the Cocoon site

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

   • C:\cocoon-2.1.7

3. Build the binary. It may run for quite a while. (Approximately 15 minutes)

   • Double-click on the build.bat file found in the direct you installed cocoon.

   • Do not be surprised by the many disturbing warning messages.

4. Copy the Xalan parser to Tomcat.

   • copy C:\cocoon-2.1.7\lib\endorsed\xalan-2.6.1-dev-20041008T0304.jar to C:\Tomcat 5.5\common\endorsed\

5. Copy over the webapp directory hierarchy as a subdirectory of the Tomcat webapps directory named cocoon

   • Create a folder called cocoon in C:\Tomcat 5.5\webapps

   • Copy C:\cocoon-2.1.7\build\webapp and paste into C:\Tomcat 5.5\webapps\cocoon /

6. Restart Tomcat from the services window:

   • Start > Programs > Apache Tomcat 5.5

   • Click on the Start button the lower left of the Tomcat console

7. View the Cocoon startup screen in your browser which should be avaliable here:

   • http://localhost:8080/cocoon/

DWang