cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robin Green" <gree...@hotmail.com>
Subject Re: more docs for Cocoon 1.7 + Tomcat 3.1
Date Thu, 24 Aug 2000 12:17:09 GMT
Looks mostly okay, I just have 2 comments.

Chris Meyer <cmeyer@ultratask.com> wrote:
>I went through the difficult process of trying to decipher the
>documentation on how to install Cocoon with Tomcat today. I don't
>know if my explanation is much better than what is there already, but
>I think it is a little more complete and 'to the point'.
>
>+    <p>
>+     Next you need to edit the
><code>$TOMCAT_HOME/webapps/WEB-INF/web.xml</code> file to point to the
>+     Cocoon properties file in the same directory. Do this by
>changing the text
>+     <code>conf/cocoon.properties</code> to
><code>WEB-INF/cocoon-properties</code>. Note that this path is a
>relative
>+     path must be so. Don't try to use an absolute path here. It
>won't work.

Actually according to the servlet 2.2 spec (IIRC), it must begin with a / 
but even so it will be treated as relative.

>Also note that
>+     the web.xml file describes how to map .xml requests to the
>Cocoon servlet.
>+    </p>
>+
>+    <p>
>+     Next you need to populate the cocoon context with source
><code>.xml</code> files. For testing purposes
>+     you can just use the samples that come along with Cocoon.
>+    </p>

Let's not get rid of these sections below please. Especially not the section 
about the xml jars which is a very FAQ!!

>-    <note>
>-      Because Cocoon now (since version 1.7.3) uses getResource() in the
>-      Servlet API to read cocoon.properties, and has different instances 
>for
>-      each servlet context, you need to put a copy of cocoon.properties in 
>all
>-      of your servlet contexts that use Cocoon. (It is recommended to put 
>it
>-      in the context's WEB-INF directory, or a password-protected 
>directory,
>-      to prevent anyone from being able to read it over the web.)
>-      However, you <strong>cannot</strong> use symbolic links on Unix to

>point
>-      to a file outside of the current context, because Tomcat does not 
>allow
>-      it for security reasons.
>-    </note>
>-
>-    <note>
>-      the <code>cocoon.properties</code> file <strong>must</strong>
>be referenced
>-      with relative paths in <code>WEB-INF/web.xml</code>, otherwise, 
>Cocoon
>-      won't be able to locate it's properties and won't be able to start.
>-    </note>
>-
>-    <p>
>-     Note that you should not need to change anything from the template
>-     properties file found in the distribution, but you must edit it for
>-     more complex operation. Please refer directly to the file that 
>contains
>-     brief indications and comments on the different configurations, but 
>you
>-     don't need to care about that at this point.
>-    </p>
>-
>-   <p>
>-    At this point, you should check if your system matches the global
>-    considerations about Cocoon properties. Usually, you might want to 
>give
>-    the installation a try as it is and then read again that section if
>-    something goes wrong. Most installations don't need any changes to
>-    be operational.
>-   </p>
>-
>-   <p>
>-    If you have upgraded Cocoon from an older version and Cocoon won't
>-    initialize, either ensure that
>-    you are using the latest cocoon.properties - or, if you are have some
>-    non-standard properties in cocoon.properties which you need to keep,
>-    refer to the latest cocoon.properties to find out what changes need to
>-    be made, if any.
>-   </p>
>-
>-   <p>
>-    Everything should now be configured fine. Restart both Apache and 
>Tomcat
>-    and try accessing the samples contained in the distribution to see
>-    Cocoon in action or the <code>/Cocoon.xml</code> page for Cocoon 
>internal
>-    status.
>-   </p>
>-
>-   <note>
>-    Make sure that <code>xerces.jar</code> is located 
><strong>before</strong>
>-    <code>xml.jar</code> otherwise Cocoon won't run. To do this, rename
>-    <code>xml.jar</code> as <code>zxml.jar</code> to be placed
later in
>-    alphabetical order.
>-   </note>
>+     Finally, you need to stop Tomcat, stop Apache, then restart the
>two in order to make
>+     all of the new settings load. You should be able to access pages like
>+     http://localhost/cocoon/Cocoon.xml and
>http://localhost/cocoon/servlets/index.xml
>+    </p>
>+


________________________________________________________________________
Get Your Private, Free E-mail from MSN Hotmail at http://www.hotmail.com


Mime
View raw message