Hello everyone,

I had some problems installing Cocoon 2.1 Dev, so I made a short how-to for
anyone interested.

I got it working thanks to previous messages in the list but took me a while
to figure it so maybe this post will save time to somebody.

Assuming a "clean" Windows 2000 system and nothing related to Java
installed.

Lets go!

------------------------------------------------

1) Download Java2 SDK Standard Edition v.1.4.1
File is j2sdk-1_4_1_01-windows-i586.exe from
http://java.sun.com/j2se/1.4.1/download.html
(Windows - SDK - All languages, including english)

2) Run j2sdk-1_4_1_01-windows-i586.exe
SDK is now installed in c:\j2sdk1.4.1_01

3) In the Windows Control Panel, go to System / Advanced Properties and
create a system variable JAVA_HOME with value "c:\j2sdk1.4.1_01" (without
quotes).

Now your system knows where the run-time environment (Java) is located.

-> Java Software Development Kit installed, now you need the Servlet Engine.

------------------------------------------------

4) Download Tomcat 4.1.12
File is jakarta-tomcat-4.1.12-LE-jdk14.zip from

http://jakarta.apache.org/builds/jakarta-tomcat-4.0/release/v4.1.12/bin/

5) Unzip everything in directory c:\jakarta-tomcat-4.1.12-LE-jdk14 (extract
using folder names)

6) Run file startup.bat located at c:\jakarta-tomcat-4.1.12-LE-jdk14/bin
Enter http://localhost:8080 in your browser and check that Tomcat (the
servlet engine) is running.

-> Tomcat installed, now you need Cocoon!

------------------------------------------------

7) Download WinCVS and Download Cocoon source.

That was pretty straightforward, following instructions available in
http://xml.apache.org/cocoon/installing/index.html

Let's assume you have now full Cocoon source (HEAD) in c:\CVS\xml-cocoon2

8) Compile Cocoon using command interface (DOS!) and type
build.bat -Dinclude.webapp.libs=yes webapp from directory c:\CVS\xml-cocoon2

9) Copy file cocoon.war from c:\CVS\xml-cocoon2\build\cocoon to
c:\jakarta-tomcat-4.1.12-LE-jdk14\webapps

10) Run file shutdown.bat located at c:\jakarta-tomcat-4.1.12-LE-jdk14/bin
to stop Tomcat

11) Run file startup.bat located at c:\jakarta-tomcat-4.1.12-LE-jdk14/bin to
startup again Tomcat.

Cocoon.war file will expand in a new directory located at
c:\jakarta-tomcat-4.1.12-LE-jdk14/webapps/cocoon

12) Stop Tomcat again (run file shutdown.bat)

13) VERY IMPORTANT!!!

You need to copy 3 files: xalan-2.4.1.jar, xercesImpl.jar and xml-apis.jar
from C:\jakarta-tomcat-4.1.12-LE-jdk14\webapps\cocoon\WEB-INF\lib
into (empty) directory c:\jakarta-tomcat-4.1.12-LE-jdk14/common/endorsed

If you don't do this step, then when you try to run Cocoon you get:

message Failed to execute pipeline.
description org.apache.cocoon.ProcessingException: Failed to execute
pipeline.:
org.apache.cocoon.CascadingIOException:
org.apache.xml.utils.WrappedRuntimeException: The output
format must have a '{http://xml.apache.org/xslt}content-handler' property!:

(as already mentioned by Antonio and solved by Volker)
See http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=103692889710176&w=2)

14) Run Tomcat again (run file startup.bat)

15) Direct your browser on http://localhost:8080/cocoon and ... it should be
working.

Check samples at http://localhost:8080/cocoon/samples/

Regards,

Franck Lumpe

Iberplus Internet, S.L.
www.iberplus.es
"E-Business Consultants"


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <[EMAIL PROTECTED]>
For additional commands, e-mail:   <[EMAIL PROTECTED]>

Reply via email to