cocoon + ias / dynamo

[michele bianchi <mi...@pow2.com>]

This is a preliminary installation guide of Cocoon 1.8 with IAS and Dynamo.
I hope it can be complete and useful.

I'll update it during the next months of course.

michele


Installing Cocoon on IAS
------------------------

Configuration tested on:

- Linux Redhat 6.2 + JWS 2.0 + IAS 4.1.1 + Cocoon 1.8.0
- Debian GNU Linux Woody + JWS 2.0 + IAS 4.1.1 + Cocoon 1.8.0
- Win2000 + JWS 2.0 + IAS 4.1.1 + Cocoon 1.8.0

1. Unjar cocoon's jars into IAS classes directory (cocoon.jar, fop.jar,
   xalan.jar, xerces.jar e turbine-pool.jar).  (we're still testing if there
   are smth better, sorry)

2. Start IAS.

3. Open the web server administration interface (not the IAS console) at
   http://your_host:9090 and login as admin.

4. Select "HTTP Web Engine", the first on the services list.

5. In the "Setup menu" select "Servlet Aliases", press the "add" button and now
   type "*.xml" on the left and "cocoon" on the right.  Remeber to press the
   "Save" button!!!!

6. Press the "Servlet" button (with the gears icon) on the top on the left,
   then the "add" button.  Type as "Servlet Name" "cocoon" and "Servlet Class"
   "org.apache.cocoon.Cocoon.class".  Press "add".  Write the description you
   like and go to press the "Properties" button (on the top).  Press "add" and
   write the init parameter, name is "properties" and value is
   "cocoon.properties" with the complete path name.  Press "Save"

7. Choose between "Load at Startup" e "Loaded Now" and press "Save" again.

8. if you are lucky Cocoon is up and running!



Installing Cocoon on Dynamo
---------------------------

Configuration tested on:

- Win2000 + Dynamo 4.5.1 + Cocoon 1.8.0

This procedure install Cocoon into the "servlet pipeline" of Dynamo.

0. You have to remove lotusxsl.jar and xml4j.jar from the CLASSPATH, xalan.jar
   and xerces.jar will work too (and better).

1. Update your system CLASSPATH with the cocoon's jars (cocoon.jar, fop.jar,
   xalan.jar, xerces.jar e turbine-pool.jar).

2. Start the "Dynamo" server and the "Developer Workbench".

3. In the "Developer Workbench" create a component in the Nucleus tree with
   name /Cocoon.

4. Edit the properties file $DYNAMO_HOME\localconfig\Cocoon.properties and add
   the line (use the correct path and the '/' character, not the '\'):

    properties=C:/Programs/cocoon-1.8/conf/cocoon.properties

5. Look for the component "/atg/dynamo/servlet/pipeline/MimeTyperServlet" and
   check the property "mimeTyper" is "/atg/dynamo/servlet/pipeline/MimeTyper".

6. Look for the component "/atg/dynamo/servlet/pipeline/MimeTyper" and check
   properties 160 and 161 are "xml" and "application/xml".  If now you have to
   add them.

7. Look for the component "/atg/dynamo/servlet/pipeline/MimeTypeDispatcher" and
   edit the proprerty "dispatcherServiceMap", add "key" = "application/xml"
   and "value" = "/Cocoon".

8. Re-start Dynamo (or try to tell him to reload the configuration...)

9. if you are lucky Cocoon is up and running!

-------------------------------------------------------------------------------
dott. michele bianchi                                       power of two s.r.l.
phone +39 335 5384700                                      http://www.pow2.com