On Wed, 11 Feb 2004 22:09:01 +0100, [EMAIL PROTECTED] said: > Hi, > > Following Geoff's suggestions you could add some > text at the top that stated that it should pretty much work with <see > Geoff's mail>, but for clarity you describe it using <your version set>. > > If you find it difficult to add it to the Wiki, I'd be glad to do it for > you. > Hi Helma,
I've added a boxout to the top right � la Geoff. Hope it's OK. I would be most grateful if you would add it to the Wiki for me as I haven't used the Wiki before. Many thanks. best, Jim -- http://www.fastmail.fm - One of many happy users: http://www.fastmail.fm/docs/quotes.html
Windows/Tomcat/Cocoon Installation
Tomcat 5.0.18/Cocoon 2.1.3 on Windows 2000 with j2sdk1.4.2_01
11 February 2004
Other Versions
- any recent tomcat
- any jdk1.4
- any cocoon release or cvs snapshot.
- 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
- Do this: Download the file called 5.0.18.zip from the Tomcat 5.0.18 section near the bottom of the Release Builds section:
http://jakarta.apache.org/site/binindex.cgiConsider this: It may be possible to use the .exe or Deployer files instead, but I used the zip.
- Do this: Extract everything to c:\ using Winzip, which should create a directory called:
c:\jakarta-tomcat-5.0.18 Consider this: You can tell Winzip will create a subdirectory by looking at the value in the path column on the right hand side.
- Do this: Set the JAVA_HOME and CATALINA_HOME environment variables.
Right-click My Computer > Properties > Advanced > Environment variables... > System Variable pane, New... etc. -
JAVA_HOME -
c:\j2sdk1.4.2_01 -
CATALINA_HOME -
c:\jakarta-tomcat-5.0.18
Consider this: Environment variables can also be set in a DOS box using DOS commands, but in that case, they are only meaningful within and for the lifetime of that DOS box.
-
- Do this: Test the server by running the batch file provided.
c:\jakarta-tomcat\bin\startup.bat Consider this: This is only one way of running the server. A better way is to install it as a Windows service.
- 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:
Consider this: Tomcat listens on port 8080 by default. Apache listens on port 80 by default. Browsers normally hit on port 80 unless told otherwise.
- Do this: Stop the server by running the batch file provided.
c:\jakarta-tomcat\bin\shutdown.bat Consider this: Because the batch file appears to hang, you will need to run this batch file from another DOS window.
- Do this: Install Tomcat as a Windows service by running the batch file provided.
c:\jakarta-tomcat\bin\service.bat Consider this: Windows services can be controlled independently throught the Services control panel.
- Do this: Change the service status to automatic for automatic start on reboot. The service should be named Apache Tomcat in:
Control Panel > Administrative Tools > Services Consider this: You can start, stop and restart any service using the corresponding button in the top panel
- Do this: Download the file called cocoon-latest-src.zip from:
http://cocoon.apache.org/mirror.cgiConsider this: It is necessary to download the entire source which can take a long time.
- Do this: Extract the source to c:\ using Winzip, which should place everything in a directory called:
c:\cocoon-2.1.3 Consider this: You can find more details on installing Cocoon in c:\cocoon-2.1.3\INSTALL.txt
- Do this: Build the binary. It may run for quite a while, in my case 30 mins.
build Consider this: During this time there will be many disturbing warning messages. You can see other build options by doing
build -projecthelp - Do this: Test Cocoon in the Jetty Servlet container.
cocoon servlet Consider this: Jetty is provided with Cocoon so that it can be tested independently of a separately installed servlet container such as Tomcat.
- Do this: View the Cocoon default installation screen here:
Consider this: Jetty listens on port 8888, but in a moment, we will configure Cocoon to run with Tomcat on port 8080.
- Do this: Stop the Jetty server.
^C Consider this: Although inelegant, I couldn't find any other way of stopping Jetty.
- Do this: Copy over the Xalan parser to Tomcat. Bit vague about this step, but seemed to work for me.
copy c:\cocoon-2.1.3\lib\endorsed\xalan.2.5.2.jar c:\jakart-tomcat-5.0.18\common\endorsed\ Consider this: The docs suggested copying over xercesXXX.jar and xml-apis.jar, but I omitted to because the versions that came with Tomcat were dated after those shipping with Cocoon.
- Do this: Copy over the webapp directory hierarchy as a subdirectory of the Tomcat webapps directory named cocoon
xcopy c:\cocoon-2.1.3\build\webapp c:\jakarta-tomcat-5.0.18\webapps\cocoon /D /S /V /I /F Consider this: Alternatively, using Windows explorer, drag and drop the webapp folder into the webapps folder whilst holding down the <ctrl> key. Then select the webapp folder, hit F2, and rename it cocoon.
- Do this: Restart Tomcat from the services window:
- Do this: View the Cocoon startup screen which should be avaliable here:
Consider this: The first time you run Cocoon, it will take some time to compile. You can create a more lean and mean Cocoon by creating and editing the files local.build.properties and local.blocks.properties.
- Do this: Delete the source if you desire to save space and keep things tidy.
rd /S c:\cocoon-2.1.3 Consider this: If you choose to keep the source and rebuild Cocoon later, you will have to clear out the build directory by doing
build clean
Consider this: Tomcat should find Cocoon when it restarts.
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
