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
|