cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From stef...@locus.apache.org
Subject cvs commit: xml-cocoon/xdocs installing.xml
Date Wed, 24 May 2000 23:07:37 GMT
stefano     00/05/24 16:07:36

  Modified:    xdocs    Tag: xml-cocoon2 installing.xml
  Log:
  cleaning up
  
  Revision  Changes    Path
  No                   revision
  
  
  No                   revision
  
  
  1.8.2.4   +63 -6     xml-cocoon/xdocs/installing.xml
  
  Index: installing.xml
  ===================================================================
  RCS file: /home/cvs/xml-cocoon/xdocs/installing.xml,v
  retrieving revision 1.8.2.3
  retrieving revision 1.8.2.4
  diff -u -r1.8.2.3 -r1.8.2.4
  --- installing.xml	2000/03/31 11:32:50	1.8.2.3
  +++ installing.xml	2000/05/24 23:07:34	1.8.2.4
  @@ -1,4 +1,4 @@
  -<?xml version="1.0"?>
  +<?xml version="1.0" encoding="ISO-8859-1" ?>
   
   <!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
   
  @@ -7,6 +7,7 @@
     <title>Installing Cocoon2</title>
     <authors>
      <person name="Stefano Mazzocchi" email="stefano@apache.org"/>
  +   <person name="Sven Künzler" email="svenk@tzi.org"/>
     </authors>
    </header>
   
  @@ -156,9 +157,65 @@
      </note>
     </s2>
   
  -  <s2 title="Installing Cocoon2 on Jakarta Tomcat">
  -   <p>yet to be written. Volunteers welcome!</p>
  -  </s2>
  - </s1>
  +  <s2 title="Installing Cocoon2 on Jakarta Tomcat 3.1">
  +	<note>This describes how to install Cocoon2 with a stand-alone, default
  +	  configuration of Tomcat 3.1. If you are using Tomcat along with Apache
  +	  or another web server,  you will most probably have to edit the
  +	  configuration of that server as well.</note> 
  +	<p>
  +	  First, create the directory path <code>[path-to-Cocoon2]/WEB-INF/lib</code>.
  +	  Copy all jar archives from <code>[path-to-Cocoon2]/lib</code>
  +	  to <code>[path-to-Cocoon2]/WEB-INF/lib</code>.  Copy cocoon.jar to
  +	  <code>[path-to-Cocoon2]/WEB-INF/lib</code>, as well.  Note that because
  +	  all of these jars are in the lib subdirectory of the WEB-INF directory,
  +	  Tomcat will automatically handle the loading of these classes, and they
  +	  don't need to be placed in the classpath.
  +	</p>
  +	<p>Create a new context for the Cocoon2 servlet to run within by appending a
  +	  new Context node to <code>[path-to-Tomcat]/conf/server.xml</code>.  The
new
  +	  Context should look like the following:
  +	</p>
  +	<source><![CDATA[
  +	[...]
  +	  <Context path="/cocoon" docBase="[path-to-Cocoon2]" debug="0" reloadable="true" >

  +	  </Context>]]></source>
  +	<note>FIXME: Oddly enough, the docBase doesn't appear to do anything for Cocoon2
at this time,
  +	  and the base appears to be determined based off of the location of the Cocoon2 configuration
  +	  file.</note>
  +	<p>Tomcat looks in the path pointed to by docBase for a WEB-INF directory and will
load
  +	  the web application information from that directory from the web.xml file.
  +	</p>
  +	<p>Now, create the file <code>[path-to-Cocoon2]/WEB-INF/web.xml</code>.
  +	  It should contain the following:</p>
  +	<source><![CDATA[
  +	  <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
  +	  "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">
  +
  +	  <web-app>
  +	    <servlet>
  +	      <servlet-name>cocoon</servlet-name>
  +	      <servlet-class>org.apache.cocoon.servlet.CocoonServlet</servlet-class>
  +	      <init-param>
  +	        <param-name>configurations</param-name>
  +	        <param-value>[path-to-Cocoon2]/conf/cocoon.xconf</param-value>
  +	      </init-param>
  +	    </servlet>
  +	    <servlet-mapping>
  +	      <servlet-name>cocoon</servlet-name>
  +	      <url-pattern>/</url-pattern>
  +	    </servlet-mapping>
  +	  </web-app>]]></source>
  +	<p>Finally, restart Tomcat, point your
  +	  browser to the following URI...
  +	</p>.
  +
  +	<source>http://localhost/cocoon/hello</source>
  +	
  +	<p>
  +	  ... and say "Hello!" to Cocoon2.
  +	</p>
  +	
  +      </s2>
  +    </s1>
   </body>
  -</document>
  \ No newline at end of file
  +</document>
  
  
  

Mime
View raw message