joerg 2003/07/09 09:58:56
Modified: site/2.1/installing index.html index.pdf jars.html jars.pdf
tests.html tests.pdf updating.html updating.pdf
Log:
updating the next directory (especially because of wrong information on
"build webapp" vs. "build war")
Revision Changes Path
1.5 +1748 -2103cocoon-site/site/2.1/installing/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/cocoon-site/site/2.1/installing/index.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- index.html 21 May 2003 15:23:24 -0000 1.4
+++ index.html 9 Jul 2003 16:58:55 -0000 1.5
@@ -1,2103 +1,1748 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Installing Apache Cocoon</title>
-<link type="text/css" href="../skin/page.css" rel="stylesheet">
-</head>
-<body text="#000000" bgcolor="#FFFFFF">
-<!--================= start Navigation Path ==================-->
-<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<tr>
-<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" border="0"
src="../skin/images/spacer.gif"><!--===== breadcrumb trail
(javascript-generated) ====--><font size="2" face="Arial, Helvetica,
Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0"
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Navigation Path ==================-->
-<!--================= start Banner ==================-->
-<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<tr>
-<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://xml.apache.org";><img border="0"
class="logoImage" alt="Apache Cocoon" src="../images/group-logo.gif"></a></td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache
Cocoon" src="../images/project-logo.gif"></a></td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
-<form target="_blank" action="http://www.google.com/search"; method="get">
-<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
-<tr>
-<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td><td nowrap="nowrap"><input
value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15"
name="q" id="query" type="text"><img height="1" width="5" alt=""
src="../skin/images/spacer.gif"><input name="Search" value="Search"
type="submit">
-<br>
-<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
- the Apache Cocoon site
-
-
- </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10"
width="9" src="../skin/images/search-right.gif"></td>
-</tr>
-</table>
-</form>
-</td>
-<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" bgcolor="#294563" colspan="2">
-<!--================= start Tabs ==================-->
-<div class="tab">
-<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td width="8"><img alt="" height="8" width="8"
src="../skin/images/spacer.gif"></td><td valign="bottom">
-<table summary="selected tab" style="height: 1.7em" border="0"
cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a href="../index.html"><font
color="#000000">Home</font></a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-</div>
-<!--================= end Tabs ==================-->
-</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Banner ==================-->
-<!--================= start Menu, NavBar, Content ==================-->
-<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top">
-<table summary="menu" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<!--================= start left top NavBar ==================-->
-<td rowspan="3" valign="top">
-<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
-</tr>
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td>
-<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img
width="10" height="10" alt="" src="../skin/images/spacer.gif"></td><td
nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
-<!--================= start Menu items ==================-->
-<div class="menu">
-<ul>
-<li>
-<font color="#CFDCED">Navigation</font>
-<ul>
-
-<li>
-<a href="../index.html">Main</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Installation</font>
-<ul>
-
-<li>
-<a target="_blank" href="http://cocoon.apache.org/mirror.cgi";>Download</a>
-</li>
-
-<li>
-<span class="sel"><font color="#ffcc00">Installing</font></span>
-</li>
-
-<li>
-<a href="updating.html">Updating</a>
-</li>
-
-<li>
-<a href="jars.html">Jars</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Testing</font>
-<ul>
-
-<li>
-<a href="tests.html">Overview</a>
-</li>
-
-</ul>
-</li>
-</ul>
-</div>
-<!--================= end Menu items ==================-->
-</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="../skin/images/spacer.gif"></td><td bgcolor="#294563"><img
width="1" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" border="0" alt="" src="../skin/images/spacer.gif"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
-</tr>
-<tr>
-<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td><td valign="top" width="100%">
-<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<!--================= start middle NavBar ==================-->
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif"></td><td align="left" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
-
- </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif"></td><td align="right" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
-
- </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img
width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end middle NavBar ==================-->
-<!--================= start Content==================-->
-<tr>
-<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td><td align="left" width="100%">
-<div class="content">
-<table class="title" summary="">
-<tr>
-<td valign="middle">
-<h1>Installing Apache Cocoon</h1>
-</td><script Language="Javascript">
-
-function printit(){
-if (window.print) {
- window.print() ;
-} else {
- var WebBrowser = '<OBJECT
CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0"
ID="WebBrowser1"></OBJECT>';
-document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
- WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box
WebBrowser1.outerHTML = "";
-}
-}
-</script><script Language="Javascript">
-var NS = (navigator.appName == "Netscape");
-var VERSION = parseInt(navigator.appVersion);
-if (VERSION > 3) {
- document.write('<td nowrap="nowrap" width="40" align="center">');
- document.write(' <a class="dida" href="javascript:printit()">');
- document.write(' <img alt="Print this Page"
src="../skin/images/printer.gif" border="0"><br>');
- document.write(' print</a>');
- document.write('</td>');
-}
-</script><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="index.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" border="0"><br>
- PDF</a></td>
-</tr>
-</table>
-<p>
-<font size="-2">by Stefano Mazzocchi, Giacomo Pati, Tom
Klaasen, Chris Stevenson, Carsten Ziegeler, Vadim
Gritsenko, Bernhard Huber, Nicola Ken Barozzi, Sylvain
Wallez</font>
-</p>
-<ul class="minitoc">
-<li>
-<a href="#System+Requirements">System Requirements</a>
-</li>
-<li>
-<a href="#Getting+Apache+Cocoon">Getting Apache Cocoon</a>
-<ul class="minitoc">
-<li>
-<a href="#Download+a+distribution">Download a distribution</a>
-</li>
-<li>
-<a href="#Download+a+development+snapshot">Download a development
snapshot</a>
-</li>
-<li>
-<a href="#Step-by-step+cvs+instructions+for+Windows">Step-by-step cvs
instructions for Windows</a>
-</li>
-<li>
-<a href="#Step-by-step+cvs+instructions+for+Unix">Step-by-step cvs
instructions for Unix</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#Configuring+Environment">Configuring Environment</a>
-<ul class="minitoc">
-<li>
-<a href="#Set+JAVA_HOME+environment+variable">Set JAVA_HOME environment
variable</a>
-</li>
-<li>
-<a href="#Java+1.4+configuration">Java 1.4 configuration</a>
-</li>
-<li>
-<a href="#JDK+Dependency">JDK Dependency</a>
-</li>
-<li>
-<a href="#UNIX+with+X+server">UNIX with X server</a>
-</li>
-<li>
-<a href="#Headless+UNIX+and+PJA">Headless UNIX and PJA</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#Building+Cocoon">Building Cocoon</a>
-<ul class="minitoc">
-<li>
-<a href="#Adding+optional+components">Adding optional components</a>
-</li>
-<li>
-<a href="#Building+a+minimal+Cocoon">Building a minimal Cocoon</a>
-</li>
-<li>
-<a href="#Running+the+build">Running the build</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#Installing+Cocoon">Installing Cocoon</a>
-<ul class="minitoc">
-<li>
-<a href="#Installing+on+Tomcat+3.3.X">Installing on Tomcat 3.3.X</a>
-</li>
-<li>
-<a href="#Installing+on+Tomcat+3.2.X">Installing on Tomcat 3.2.X</a>
-</li>
-<li>
-<a href="#Installing+on+Tomcat+4.0+-+4.0.1%2C+4.0.4b1">Installing on Tomcat
4.0 - 4.0.1, 4.0.4b1</a>
-</li>
-<li>
-<a href="#Installing+on+Tomcat+4.0.3">Installing on Tomcat 4.0.3</a>
-</li>
-<li>
-<a href="#Installing+on+Tomcat+4.0.4b1+LE+with+JDK+1.4.0">Installing on
Tomcat 4.0.4b1 LE with JDK 1.4.0</a>
-</li>
-<li>
-<a href="#Installing+on+BEA+Weblogic+6.0sp2">Installing on BEA Weblogic
6.0sp2</a>
-</li>
-<li>
-<a
href="#Installing+on+ServletExec+3.1+%28In+Process+with+IIS%29">Installing on
ServletExec 3.1 (In Process with IIS)</a>
-</li>
-<li>
-<a
href="#Installing+on+JBoss+2.4.4+with+Tomcat+4.0.1+%28Catalina%29">Installing
on JBoss 2.4.4 with Tomcat 4.0.1 (Catalina)</a>
-</li>
-<li>
-<a href="#Installing+on+JBoss+2.2.2+with+Tomcat+3.2.2">Installing on JBoss
2.2.2 with Tomcat 3.2.2</a>
-</li>
-<li>
-<a href="#Installing+on+Resin+2.x">Installing on Resin 2.x</a>
-</li>
-<li>
-<a href="#Installing+on+HP-AS+8.X">Installing on HP-AS 8.X</a>
-</li>
-<li>
-<a href="#Installing+on+JRun+3.1">Installing on JRun 3.1</a>
-</li>
-<li>
-<a
href="#Installing+on+iPlanet+Web+Server+4.x+and+other+engines+without+context+management">Installing
on iPlanet Web Server 4.x and other engines without context management</a>
-</li>
-<li>
-<a href="#Installing+on+WebSphere+4.0">Installing on WebSphere 4.0</a>
-</li>
-</ul>
-</li>
-</ul>
-
-<a name="N10034"></a><a name="System+Requirements"></a>
-<h3>System Requirements</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- Apache Cocoon requires the following systems to be already installed
in your system:
- </p>
-<p>
-<strong>Java Virtual Machine</strong>
- A Java 1.3 or later compatible virtual machine must be present for
both
- command line and servlet type usage of Apache Cocoon. Note that all
servlet engines
- require a JVM to run so if you are already using servlets you already
have
- one installed.
- </p>
-<p>
-<strong>Servlet Engine</strong>
- A Servlet 2.2 compliant servlet engine must be present in order to
support
- servlet operation and dynamic request handling. Note that this
requirement
- is optional for command line operation. Note also that Cocoon now
ships
- with a stripped down version of Jetty suitable for immediately
testing
- with no further downloads.
- </p>
-<p>When the time comes to run your Cocoon application in a full featured
- servlet container, you may want to consider the following Open Source
- options:</p>
-<ol>
-
-<li>The Apache Tomcat project
- <a
href="http://jakarta.apache.org/tomcat/";>http://jakarta.apache.org/tomcat/</a>
-
-</li>
-
-<li>The full version of Jetty
- <a
href="http://jetty.mortbay.org/";>http://jetty.mortbay.org/</a>
-
-</li>
-
-</ol>
-</div>
-
-
-<a name="N1005B"></a><a name="Getting+Apache+Cocoon"></a>
-<h3>Getting Apache Cocoon</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- You have three choices for getting Cocoon: you can either download
- a stable release, or you can download development snapshot, or you can
- get the latest development version directly from the cvs repository.
- </p>
-<a name="N10063"></a><a name="Download+a+distribution"></a>
-<h4>Download a distribution</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- You can simply download the latest official release from the
- <a href="http://cocoon.apache.org/mirror.cgi";>Cocoon distribution</a>
- directory.
- </p>
-</div>
-<a name="N10070"></a><a name="Download+a+development+snapshot"></a>
-<h4>Download a development snapshot</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- You also can download one of the development snapshots from the
- <a href="http://xml.apache.org/cocoon/mirror.cgi#nightly";>CVS
snapshots</a>
- directory.
- </p>
-</div>
-<a name="N1007D"></a><a name="Step-by-step+cvs+instructions+for+Windows"></a>
-<h4>Step-by-step cvs instructions for Windows</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>See the Cocoon document
- <a href="../contrib.html">Contrib</a>
- for starting tips.
- </p>
-<ol>
-
-<li>Download
- <a
href="http://telia.dl.sourceforge.net/cvsgui/WinCvs120.zip";>WinCVS
- (v1.2)</a> (homepage is <a
href="http://www.wincvs.org/";>http://www.wincvs.org/</a>);
- </li>
-
-<li>Install it;</li>
-
-<li>Start it;</li>
-
-<li>Click on admin->preferences;</li>
-
-<li> In "Enter the CVSROOT:" enter
- ":pserver:[EMAIL PROTECTED]:/home/cvspublic" (without
quotes);</li>
-
-<li>In "Authentication:" choose ""passwd" file on the cvs server";</li>
-
-<li>Click "Ok";</li>
-
-<li>Click admin->login;</li>
-
-<li> When asked for the password: answer "anoncvs" (without quotes);</li>
-
-<li> Click "create->checkout module";</li>
-
-<li>Module name and path on the server is "cocoon-2.1" (no quotes);</li>
-
-<li>Choose a dir to put the source code in;</li>
-
-<li>Go to the "Checkout-options" tab and select "By revision/tag/branch"
- and enter "HEAD";</li>
-
-<li>Click "Ok";</li>
-
-<li>If everything goes well, messages will start to appear in the log
- window;</li>
-
-<li>Wait until you see "*****CVS exited normally with code 0*****" in the
- log window;</li>
-
-<li>The Cocoon source is now on your harddrive.</li>
-
-</ol>
-</div>
-<a name="N100C8"></a><a name="Step-by-step+cvs+instructions+for+Unix"></a>
-<h4>Step-by-step cvs instructions for Unix</h4>
-<div style="margin-left: 0 ; border: 2px">
-<ol>
-
-<li>Start the shell of your choice.</li>
-
-<li>Enter "cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login".</li>
-
-<li>When asked for the password: answer "anoncvs".</li>
-
-<li>Enter "cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic -z3 checkout
- -r HEAD cocoon-2.1". This will create a directory called
"cocoon-2.1" where the
- Cocoon2 source will be stored.</li>
-
-<li>Wait until cvs has finished.</li>
-
-<li>The Cocoon source is now on your harddrive.</li>
-
-</ol>
-<p>In case you want to update your Cocoon source tree to the
- current version, change to the "cocoon-2.1" directory and
- call "cvs -z3 update -d -P".</p>
-</div>
-</div>
-
-
-<a name="N100E7"></a><a name="Configuring+Environment"></a>
-<h3>Configuring Environment</h3>
-<div style="margin-left: 0 ; border: 2px">
-<a name="N100EC"></a><a name="Set+JAVA_HOME+environment+variable"></a>
-<h4>Set JAVA_HOME environment variable</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Set the JAVA_HOME environment variable to point to the root directory of
- the Java Development Kit installed on your machine. To do this
simply type:</p>
-<pre class="code">
-[unix] JAVA_HOME=/path/to/java/
-[win32] SET JAVA_HOME=c:\path\to\java</pre>
-<p>Your mileage may vary, but you know how to setup environments, right?</p>
-</div>
-<a name="N100FD"></a><a name="Java+1.4+configuration"></a>
-<h4>Java 1.4 configuration</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Cocoon requires more recent versions of the Xerces and Xalan libraries
- than those shipped with j2se 1.4. To override bundled libraries,
follow
- these steps:
- </p>
-<ol>
-
-<li>
- Create <span
class="codefrag">%JAVA_HOME%\jre\lib\endorsed</span> directory. (Tomcat users
- use <span class="codefrag">%TOMCAT_HOME\common\endorsed</span>
instead)
- </li>
-
-<li>
- Copy <span class="codefrag">xercesXXX.jar</span>, <span
class="codefrag">xalan-XXX.jar</span>,
- and the <span class="codefrag">xml-apis.jar</span> from the
- <span class="codefrag">.\lib\endorsed\</span> to the new
directory created above.
- </li>
-
-</ol>
-<p>Due to changes in JDBC between JDK 1.3 and JDK 1.4, it is not possible
- to use Cocoon built on JDK 1.3 with JDK 1.4 when it comes to
database
- connections. Make sure you prepare cocoon with a JDK that
matches the
- one you will deploy on.
- </p>
-</div>
-<a name="N10124"></a><a name="JDK+Dependency"></a>
-<h4>JDK Dependency</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Cocoon requires a Java compiler for installation and for running some
- components like XSP etc. For components, the default
configuration of
- Cocoon does not use the compiler in JAVA_HOME, but a version
shipped
- with Cocoon.
- </p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">You can configure which compiler Cocoon uses in
WEB-INF/lib.
- </div>
-</div>
-</div>
-<div class="frame fixme">
-<div class="label">Fixme (
- ghoward
-
- )</div>
-<div class="content">Is this still an issue?</div>
-</div>
-<a name="N10134"></a><a name="UNIX+with+X+server"></a>
-<h4>UNIX with X server</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Cocoon is bundled with the <a
href="http://xml.apache.org/batik/";>Batik</a>
- (SVG rasterization toolkit) to deliver SVG imaging capabilities.
Batik uses Java
- <span class="codefrag">java.awt</span> library, which (at least in
Sun JDK before 1.4) requires
- graphics display. This means that X server must be running and
Cocoon should
- have permission to connect to it.</p>
-<p>Easiest way to avoid X server connection problem (and to have mentioned
permission)
- is to install and run Cocoon and entire servlet engine of your
choice under regular
- user account.</p>
-<p>For security, and many other reasons, X server can be replaced by Xfvb
- or PJA (alternative awt implementation).</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Sun JDK 1.4 does not require graphics display anymore,
but Java has to be
- started with the argument <span
class="codefrag">-Djava.awt.headless=true</span>,
- and X libraries still must be installed.</div>
-</div>
-</div>
-<div class="frame fixme">
-<div class="label">Fixme (
- ghoward
-
- )</div>
-<div class="content">Is this still an issue?</div>
-</div>
-<a name="N10154"></a><a name="Headless+UNIX+and+PJA"></a>
-<h4>Headless UNIX and PJA</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>If you are using unix with the Sun JDK 1.4, it can run in the
- headless environment (but you still must have X libraries
installed!)
- when following option is provided on Java startup:</p>
-<pre class="code">-Djava.awt.headless=true</pre>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">If you use Tomcat, this can be done by setting
environment variable
- CATALINA_OPTS (Tomcat 4.x), or TOMCAT_OPTS (Tomcat 3.x):</div>
-</div>
-<pre class="code">export CATALINA_OPTS='-Djava.awt.headless=true'</pre>
-<p>If you are using unix with the Sun JDK 1.3.1 or earlier, it's awt
- implementation requires you to use X even if you aren't actually
- displaying anything. One simple solution is to use a different
- implementation of the awt.</p>
-<ol>
-
-<li>From www.eteks.com you can get an awt replacement that doesn't need X:
- <a
href="http://www.eteks.com/pja/en/";>http://www.eteks.com/pja/en/</a>.</li>
-
-<li>Then add the following options to the Java command starting your
container:
- </li>
-
-</ol>
-<pre class="code">
--Xbootclasspath/a:/path/to/pja.jar
--Dawt.toolkit=com.eteks.awt.PJAToolkit
--Djava.awt.graphicsenv=com.eteks.java2d.PJAGraphicsEnvironment
--Djava.awt.fonts=/usr/local/jdk/jre/lib/fonts/</pre>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">If you use Tomcat, this can be done by setting
environment variable
- CATALINA_OPTS (Tomcat 4.x), or TOMCAT_OPTS (Tomcat 3.x):</div>
-</div>
-<pre class="code">
-export CATALINA_OPTS='-Xbootclasspath/a:/path/to/pja.jar \
- -Dawt.toolkit=com.eteks.awt.PJAToolkit \
- -Djava.awt.graphicsenv=com.eteks.java2d.PJAGraphicsEnvironment \
- -Djava.awt.fonts=/usr/local/jdk/jre/lib/fonts/'</pre>
-</div>
-</div>
-
-
-<a name="N10188"></a><a name="Building+Cocoon"></a>
-<h3>Building Cocoon</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>If you downloaded the binary distribution of Cocoon, you can
- skip this chapter and proceed to the "Installing Cocoon".
- </p>
-<a name="N10192"></a><a name="Adding+optional+components"></a>
-<h4>Adding optional components</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- Some of the components delivered with Cocoon require additional
libraries,
- e.g. the Php generator or the FOP serializer (for more information
about
- these components, refer to their documentation).
- </p>
-<p>
- Most of these libraries are already included in the distribution, but
some
- have to be downloaded manually. The build task checks whether you have
- the required libraries or not and includes the optional components only
- if you have the libraries available when you build Cocoon. Refer to the
- <a href="jars.html">Cocoon JARs</a> page for a list of libraries
- and locations where you could get them.
- </p>
-<p>
- A library/package is available to the build process when it is located
- in the <span class="codefrag">./lib/optional</span> or the <span
class="codefrag">./lib/local</span> directory.
- </p>
-<p>
- The following table contains a list of the optional components,
- their needed libraries and if they are already included or not.
- </p>
-<table class="ForrestTable" cellspacing="1" cellpadding="4">
-
-<tr>
-
-<th colspan="1" rowspan="1">Component</th>
- <th colspan="1" rowspan="1">Required Library</th>
- <th colspan="1" rowspan="1">Library Included</th>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">HTML Generator</td>
- <td colspan="1" rowspan="1"><a
href="http://sourceforge.net/projects/jtidy";>JTidy</a></td>
- <td colspan="1" rowspan="1">Yes</td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">Php Generator</td>
- <td colspan="1" rowspan="1"><a href="http://www.php.net";>Php
Servlet</a></td>
- <td colspan="1" rowspan="1">No</td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">LDAP Transformer</td>
- <td colspan="1" rowspan="1"><a
href="http://java.sun.com/products/jndi";>JNDI</a></td>
- <td colspan="1" rowspan="1">No</td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">PDF Serializer</td>
- <td colspan="1" rowspan="1"><a
href="http://xml.apache.org/fop/index.html";>FOP</a></td>
- <td colspan="1" rowspan="1">Yes</td>
-
-</tr>
-
-<tr>
-
-<td colspan="1" rowspan="1">RTF Serializer</td>
- <td colspan="1" rowspan="1"><a
href="http://www.jfor.org";>jfor</a></td>
- <td colspan="1" rowspan="1">No</td>
-
-</tr>
-
-</table>
-<p>If you want to add additional libraries, put them in the <span
class="codefrag">./lib/local</span>
- directory as this directory is not touched by CVS.
- <strong>Note:</strong> If you added a library/package, you
- need to rebuild Cocoon as described in 'Create the Cocoon WAR package'.
- </p>
-</div>
-<a name="N10232"></a><a name="Building+a+minimal+Cocoon"></a>
-<h4>Building a minimal Cocoon</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>If you want to build a minimal Cocoon, simply remove all optional
libraries
- from the <span class="codefrag">./lib/local</span> and the <span
class="codefrag">./lib/optional</span> directory.
- Make a <span class="codefrag">build clean</span> and then a build
with the target you want.
- However, if you want to build a web application make sure you leave
the
- <span class="codefrag">servlet.jar</span> in the <span
class="codefrag">./lib/optional</span> directory.
- </p>
-<p>
-<strong>Note:</strong>This feature is only available in the latest developer
- version of Cocoon which you can find in the CVS. </p>
-</div>
-<a name="N1024F"></a><a name="Running+the+build"></a>
-<h4>Running the build</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Cocoon uses <a href="http://jakarta.apache.org/ant/";>Jakarta Ant</a>
- for the build and installation, and comes with a build script
- ([unix]./build.sh, [win32] .\build.bat) that automates the process.</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">If you want to use build.xml directly with your copy of
Ant, please
- run the build script at least once after every CVS checkout, to ensure
that
- extra initializations like jar copying are done correctly.</div>
-</div>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">The UNIX build script (build.sh) overrides the existing
ANT_HOME variable.</div>
-</div>
-<p>There are basically two options that can be set as parameters to
- the script: <strong>targets</strong> and
<strong>properties</strong>.</p>
-<a name="N1026A"></a><a name="About+build+targets"></a>
-<h5>About build targets</h5>
-<div style="margin-left: 0 ; border: 2px">
-<p>Targets are the execution units available in
- <a href="http://jakarta.apache.org/ant/";>Ant</a> build files.</p>
-<p>Only one target can be specified per run, by appending it to
- the script invocation:</p>
-<pre class="code">
-[unix] ./build.sh target
-[win32] .\build.bat target</pre>
-</div>
-<a name="N1027F"></a><a name="About+build+properties"></a>
-<h5>About build properties</h5>
-<div style="margin-left: 0 ; border: 2px">
-<p>A target can use properties, that can, or must in some cases, be
specified.
- Multiple properties can be set, by appending them like this to
- the script invocation:</p>
-<pre class="code">
-[unix] ./build.sh -Dpropertyname=propertyvalue [target]
-[win32] .\build.bat -Dpropertyname=propertyvalue [target]</pre>
-</div>
-<a name="N1028D"></a><a name="Cocoon+build+targets"></a>
-<h5>Cocoon build targets</h5>
-<div style="margin-left: 0 ; border: 2px">
-<p>The <strong>build.xml</strong> file comes with some basic
- important targets. If no target is specified, the default one
- is used (defined in build.xml).</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Some targets are preliminary and their call method will
change
- in the future. Preliminary targets are marked as [BETA].</div>
-</div>
-<p>Cocoon targets place work files and results in a build directory
- under the cocoon root. The only exception are the distribution
targets
- that build in a directory called dist.</p>
-<p>The target you will most use is propably the <strong>webapp</strong>
- target which builds a Cocoon web application. For more information
see below.</p>
-<a name="N102A4"></a><a name="build+all"></a>
-<h6>build all</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Builds all main Cocoon targets to create the <strong>cocoon.jar</strong>
- package.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> all</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">This is currently the default target.</div>
-</div>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Available in interactive build.</div>
-</div>
-</div>
-<a name="N102C8"></a><a name="build+interactive"></a>
-<h6>build interactive</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Shows common build targets and asks the user for eventual
- properties that may be needed.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> interactive</li>
-
-<li>
-<strong>required properties:</strong> none - asks if needed</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">This is the recommended target for first-time
users.</div>
-</div>
-</div>
-<a name="N102E6"></a><a name="%5BBETA%5D+build+installwar"></a>
-<h6>[BETA] build installwar</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Builds and installs Cocoon war package in a specified directory.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> installwar</li>
-
-<li>
-<strong>required properties:</strong>
- asks the user for installation path</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">This is the recommended target for an easy install in
Tomcat.</div>
-</div>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Available in interactive build.</div>
-</div>
-</div>
-<a name="N10307"></a><a name="build+docs"></a>
-<h6>build docs</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Builds the Cocoon documentation in html format.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> docs</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Available in interactive build.</div>
-</div>
-</div>
-<a name="N10325"></a><a name="build+javadocs"></a>
-<h6>build javadocs</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Builds the Cocoon javadocs in html format.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> javadocs</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Available in interactive build.</div>
-</div>
-</div>
-<a name="N10343"></a><a name="build+printer-docs"></a>
-<h6>build printer-docs</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Builds the Cocoon documentation in html printer-friendly format.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> printer-docs</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Available in interactive build.</div>
-</div>
-</div>
-<a name="N10361"></a><a name="build+test"></a>
-<h6>build test</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Runs Cocoon unit tests.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> test</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Available in interactive build.</div>
-</div>
-</div>
-<a name="N1037F"></a><a name="build+compile"></a>
-<h6>build compile</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Compiles Cocoon source files.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> compile</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Available in interactive build.</div>
-</div>
-</div>
-<a name="N1039D"></a><a name="build+clean"></a>
-<h6>build clean</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Cleans the build directory. It is recommended to clean Cocoon
- build directory every time you upgrade Cocoon, or add/remove
- libraries from the <span class="codefrag">./lib/optional/</span>
- directory, or change JDK version.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> clean</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Available in interactive build.</div>
-</div>
-</div>
-<a name="N103BE"></a><a name="build+dist"></a>
-<h6>build dist</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Creates source and binary distributions of Cocoon. This target
- is not intented for the usual Cocoon user; it's primary used
- by the Cocoon developers to create a new distribution.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> dist</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">The results are in the dist directory.</div>
-</div>
-</div>
-<a name="N103DC"></a><a name="build+webapp"></a>
-<h6>build webapp</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Creates the Cocoon WAR package. It's a non-interactive version
- of installwar.</p>
-<ul>
-
-<li>
-<strong>target:</strong> webapp</li>
-
-<li>
-<strong>required properties:</strong> none</li>
-
-<li>
-<strong>buildfile:</strong> build.xml</li>
-
-</ul>
-<p>To do this you simply have to type:</p>
-<pre class="code">
-[unix] ./build.sh webapp
-[win32] .\build.bat webapp</pre>
-<p>this will create the <span class="codefrag">cocoon.war</span> file in the
- <span class="codefrag">./build/cocoon</span> directory. Follow
instructions in the next
- chapter to deploy this webapp in your container.</p>
-<p>If you want a "clean" web application, you can specify these optional
- properties:</p>
-<ul>
-
-<li>exclude.webapp.samples : to exclude the samples</li>
-
-<li>exclude.webapp.documentation : to exclude the documentation</li>
-
-<li>exclude.webapp.javadocs : to exclude the java docs</li>
-
-<li>exclude.webapp.libs : to exclude the jar libraries</li>
-
-</ul>
-<p>So, if you first remove all libraries from the <span
class="codefrag">./lib/local</span>
- and the <span class="codefrag">./lib/optional</span> directory
except the <span class="codefrag">servlet.jar</span>
- and then type:</p>
-<pre class="code">
-[unix] ./build.sh -Dexclude.webapp.samples=yes
- -Dexclude.webapp.documenation=yes
- -Dexclude.webapp.javadocs=yes webapp
-[win32] .\build.bat -Dexclude.webapp.samples=yes
- -Dexclude.webapp.documenation=yes
- -Dexclude.webapp.javadocs=yes webapp</pre>
-<p>you get a minimal Cocoon web application without any samples or
documentation.
- But remember to make a <span class="codefrag">build clean</span>
beforehand.</p>
-<p>
-<strong>Note:</strong>This feature is only available in the latest developer
- version of Cocoon which you can find in the CVS. </p>
-</div>
-<a name="N10436"></a><a name="%5BBETA%5D+build+try"></a>
-<h6>[BETA] build try</h6>
-<div style="margin-left: 0 ; border: 2px">
-<p>Makes it possible to try new build targets that have not yet made
- it into the core build. These targets are in tools/builds/try.xml.
- </p>
-<ul>
-
-<li>
-<strong>target:</strong> try</li>
-
-<li>
-<strong>required properties:</strong> try.target</li>
-
-<li>
-<strong>buildfiles:</strong> build.xml, tools/build-t.xml</li>
-
-</ul>
-<p>To test target test-target for example, you simply have to type:</p>
-<pre class="code">
-[unix] ./build.sh try -Dtry.target=test-target
-[win32] .\build.bat try -Dtry.target=test-target</pre>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Targets are in tools/build-t.xml.</div>
-</div>
-</div>
-</div>
-</div>
-</div>
-
-
-<a name="N1045F"></a><a name="Installing+Cocoon"></a>
-<h3>Installing Cocoon</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>In most servlet engines, this is just a matter of copying
- the war file in a specific directory and the engine will take
- care of installing it when restarted.</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">The first time that you start Cocoon, it will take a few
- seconds, since Cocoon needs to compile parts of itself.</div>
-</div>
-<p>After that, point your browser to
- <span class="codefrag">http://localhost:8080/cocoon/</span> which will
generate the live
- <a href="../overview.html#samples">Samples</a> and also lead you
- to the live local Cocoon documentation.</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">With the 2.1 version,
- <span class="codefrag">http://localhost:8080/cocoon/</span> goes
directly to the
- documentation, while
- <span class="codefrag">http://localhost:8080/cocoon/samples/</span> is
the Samples.
- </div>
-</div>
-<a name="N1047D"></a><a name="Installing+on+Tomcat+3.3.X"></a>
-<h4>Installing on Tomcat 3.3.X</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>This is a very easy installation.</p>
-<ol>
-
-<li>
- Build the Cocoon webapp as described above.
- </li>
-
-
-<li>
- Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span>
- into <span class="codefrag">tomcat/webapps</span> directory.
- </li>
-
-
-<li>
- Start Tomcat: Go to the <span class="codefrag">tomcat/bin</span>
directory,
- and run the startup script.
- </li>
-
-
-<li>
- Open the Cocoon welcome page:
- <span class="codefrag">http://localhost:8080/cocoon/</span>
-
-</li>
-
-
-<li>
- Congratulations! You should see the Cocoon welcome page.
- </li>
-
-</ol>
-</div>
-<a name="N104A4"></a><a name="Installing+on+Tomcat+3.2.X"></a>
-<h4>Installing on Tomcat 3.2.X</h4>
-<div style="margin-left: 0 ; border: 2px">
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Cocoon requires Tomcat version 3.2 or greater. It
wouldn't work
- with Tomcat 3.1.X</div>
-</div>
-<p>Tomcat currently uses a different version of the XML parser
- than Cocoon. To get Cocoon to work, you need to perform the
- following steps:</p>
-<ol>
-
-
-<li>
-
-<strong>Stop Tomcat</strong>
- Go to the tomcat/bin directory, and run the shutdown script.
- </li>
-
-
-<li>
-
-<strong>Delete tomcat/lib/jaxp.jar</strong>
- Tomcat's jaxp.jar is 'sealed', and since xerces contains its
- own implementation of the JAXP standard extension, Java
- will fail to load xerces and report a 'Package Sealing Violation'
- if both are in the classpath.
- </li>
-
-
-<li>
-
-<strong>Rename tomcat/lib/parser.jar to tomcat/lib/zparser.jar</strong>
- Tomcat's parser.jar contains older versions of some the same
- XML APIS that Xerces uses, and these will prevent Xerces from
- functioning properly if they appear before Xerces in the classpath.
- Since Tomcat's startup scripts automatically load all the jar files
- in tomcat/lib in name order, changing the name of the file causes
it
- to be loaded last in the classpath.
- </li>
-
-
-<li>
-
-<strong>Copy the cocoon/lib/core/xerces-XXX.jar and
cocoon/lib/core/xml-apis.jar
- JAR files to tomcat/lib</strong>
- Cocoon will now be able to see and use the correct XML libraries.
- </li>
-
-
-<li>
-
-<strong>Copy cocoon/build/cocoon/cocoon.war into tomcat/webapps</strong>
-
-</li>
-
-
-<li>
-
-<strong>Start Tomcat</strong>
- Go to the tomcat/bin directory, and run the startup script.
- </li>
-
-
-<li>
-
-<strong>Start using Cocoon</strong>
- Access the URI
- <span class="codefrag">http://localhost:8080/cocoon/</span>
- with your favorite browser and start to enjoy the world of Cocoon.
- </li>
-
-</ol>
-</div>
-<a name="N104E0"></a><a
name="Installing+on+Tomcat+4.0+-+4.0.1%2C+4.0.4b1"></a>
-<h4>Installing on Tomcat 4.0 - 4.0.1, 4.0.4b1</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Tomcat 4 is a really straight-forward installation.</p>
-<ol>
-
-<li>
- Build the Cocoon webapp as described above.
- </li>
-
-
-<li>
- Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span>
into
- <span class="codefrag">tomcat/webapps</span> directory.
- </li>
-
-
-<li>
- Start Tomcat: Go to the <span class="codefrag">tomcat/bin</span>
directory,
- and run the startup script.
- </li>
-
-
-<li>
- Open the Cocoon welcome page:
- <span class="codefrag">http://localhost:8080/cocoon/</span>
-
-</li>
-
-
-<li>
- Congratulations! You should see the Cocoon welcome page.
- </li>
-
-</ol>
-</div>
-<a name="N10507"></a><a name="Installing+on+Tomcat+4.0.3"></a>
-<h4>Installing on Tomcat 4.0.3</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>If you have to use Tomcat 4.0.3, you have to replace its
- XML parser with the one shipped with Cocoon.</p>
-<ol>
-
-<li>Remove <span class="codefrag">tomcat/common/lib/xerces.jar</span> file.
- </li>
-
-
-<li>Copy following libraries from the <span
class="codefrag">cocoon/lib/core</span>
- directory to the tomcat/common/lib directory:
- <ul>
-
-<li>xalan-XXX.jar</li>
-
-<li>xercesImpl-XXX.jar</li>
-
-<li>xml-apis.jar</li>
-
-</ul>
-
-</li>
-
-
-<li>Copy <span class="codefrag">cocoon/lib/optional/batik-all-XXX.jar</span>
- to the tomcat/common/lib directory.</li>
-
-
-<li>Edit <span class="codefrag">extra-classpath</span> parameter in the
- <span class="codefrag">cocoon/src/webapp/WEB-INF/web.xml</span>
file:
- </li>
-
-</ol>
-<p>For UNIX:</p>
-<pre class="code">
-<init-param>
- <param-name>extra-classpath</param-name>
- <param-value>/tomcat/common/lib/xalan-XXX.jar:
-/tomcat/common/lib/xercesImpl-XXX.jar:
-/tomcat/common/lib/xml-apis.jar:
-/tomcat/common/lib/batik-all-XXX.jar</param-value>
-</init-param>
-</pre>
-<p>For Windows:</p>
-<pre class="code">
-<init-param>
- <param-name>extra-classpath</param-name>
- <param-value>C:\tomcat\common\lib\xalan-XXX.jar;
-C:\tomcat\common\lib\xercesImpl-XXX.jar;
-C:\tomcat\common\lib\xml-apis.jar;
-C:\tomcat\common\lib\batik-all-XXX.jar</param-value>
-</init-param>
-</pre>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">param-value should be in one line!
- Also, replace <span class="codefrag">/tomcat/</span> (UNIX), <span
class="codefrag">C:\tomcat\</span>
- (Windows) with the path to your Tomcat installation home.</div>
-</div>
-<ol>
-
-<li>
- Clean Cocoon build directory: <span class="codefrag">build
clean</span>
-
-</li>
-
-
-<li>
- Build Cocoon webapp: <span class="codefrag">build webapp</span>
-
-</li>
-
-
-<li>
- Remove xalan-XXX.jar, xercesImpl-XXX.jar, batik-all-XXX.jar,
- and xml-apis.jar from the cocoon.war archive.
- </li>
-
-
-<li>
- Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span>
into
- <span class="codefrag">tomcat/webapps</span> directory.
- </li>
-
-
-<li>
- Start Tomcat: Go to the <span class="codefrag">tomcat/bin</span>
directory,
- and run the startup script.
- </li>
-
-
-<li>
- Open the Cocoon welcome page:
- <span class="codefrag">http://localhost:8080/cocoon/</span>
-
-</li>
-
-
-<li>
- Congratulations! You should see the Cocoon welcome page.
- </li>
-
-</ol>
-</div>
-<a name="N1057D"></a><a
name="Installing+on+Tomcat+4.0.4b1+LE+with+JDK+1.4.0"></a>
-<h4>Installing on Tomcat 4.0.4b1 LE with JDK 1.4.0</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>This combination is also easy to install.</p>
-<ol>
-
-<li>
- Build the Cocoon webapp as described above.
- </li>
-
-
-<li>
- Copy <span
class="codefrag">cocoon-2.1/build/cocoon/cocoon.war</span> into
- <span class="codefrag">tomcat/webapps</span> directory.
- </li>
-
-
-<li>
- Set environment variable <span
class="codefrag">CATALINA_OPTS=-Djava.awt.headless=true</span>
-
-</li>
-
-
-<li>
- Start Tomcat: Go to the <span class="codefrag">tomcat/bin</span>
directory,
- and run the startup script.
- </li>
-
-
-<li>
- Open the Cocoon welcome page:
- <span class="codefrag">http://localhost:8080/cocoon/</span>
-
-</li>
-
-<li>
- Congratulations! You should see the Cocoon welcome page.
- </li>
-
-</ol>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">
- Make sure that JAVA_HOME enviroment variable points to the JDK1.4.0.
- If you had JDK1.3.1 or earlier before, <span class="codefrag">build
clean</span> before
- all these steps.
- </div>
-</div>
-</div>
-<a name="N105B0"></a><a name="Installing+on+BEA+Weblogic+6.0sp2"></a>
-<h4>Installing on BEA Weblogic 6.0sp2</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>This installs Cocoon using the cocoon.war file.
- This was successfully installed under Windows 2000 and JDK 1.3.1.
- Unix users will need to adjust appropriately. If you haven't done
so already,
- build a domain and a server. In this discussion, the name of the
domain
- is 'mydomain', the name of the server is 'myserver', and WebLogic
installation
- directory is <span class="codefrag">c:\bea\wlserver6.0sp2\</span>.
These are the BEA defaults.
- </p>
-<ol>
-
-<li>
- Build the Cocoon webapp as described above.
- </li>
-
-<li>
- Copy <span class="codefrag">cocoon\build\cocoon\webapp</span>
directory into the
- <span
class="codefrag">c:\bea\wlserver6.0sp2\config\mydomain\applications\</span>
- directory of your WebLogic server.
- </li>
-
-<li>
- Copy the <span class="codefrag">xerces-XXX.jar</span> and <span
class="codefrag">xml-apis.jar</span> JAR files from the
- <span class="codefrag">cocoon\lib\core\</span> to the directory of
your choice, say <span class="codefrag">c:\bea\</span>.
- </li>
-
-<li>
- Add to the config.xml of the WebLogic server following snippet:
- </li>
-
-</ol>
-<pre class="code">
-<Application Deployed="true" Name="Cocoon"
- Path="./config/mydomain/applications">
- <WebAppComponent Name="cocoon"
- Targets="myserver"
- URI="cocoon"/>
-</Application>
-</pre>
-<ol>
-
-<li>
- Edit <span
class="codefrag">c:\bea\wlserver6.0sp2\config\mydomain\startWebLogic.cmd</span>
file,
- add xerces and xml-apis JAR files to the classpath:
- </li>
-
-</ol>
-<pre class="code">
-set CLASSPATH=c:\bea\xerces-XXX.jar;c:\bea\xml-apis.jar
-set CLASSPATH=%CLASSPATH%;.;.\lib\weblogic_sp.jar
-set CLASSPATH=%CLASSPATH%;.\lib\weblogic.jar
-</pre>
-<ol>
-
-<li>
- Start WebLogic server using <span
class="codefrag">startWebLogic.cmd</span>.
- </li>
-
-<li>
- Using a browser, you might want to check WebLogic configuration
using console:
- <span class="codefrag">http://localhost:7001/console/</span>.
- </li>
-
-
-<li>
- Open the Cocoon welcome page:
- <span class="codefrag">http://localhost:7001/cocoon/</span>
- (Don't forget the final '/' in the link.)
- </li>
-
-<li>
- Congratulations! You should see the Cocoon welcome page.
- </li>
-
-</ol>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Because of some issues with this version of WebLogic,
you will
- see lots of exceptions in the WebLogic's console window.
- </div>
-</div>
-</div>
-<a name="N1060D"></a><a
name="Installing+on+ServletExec+3.1+%28In+Process+with+IIS%29"></a>
-<h4>Installing on ServletExec 3.1 (In Process with IIS)</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>This installs Cocoon in a "war" configuration. This was successfully
- installed under Windows NT 4.0 and IIS 4. I don't believe that SE
is
- available for unix.</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Please note that <em>JDK 1.3</em> is required.</div>
-</div>
-<ol>
-
-<li>Install IIS as usual</li>
-
-<li>Install ServletExec (default paths will be used throughout), but
- don't start it.</li>
-
-<li>Build Cocoon's war file (include lib's)</li>
-
-<li>Copy <em>cocoon.war</em> into
- <em>C:\Program Files\New Atlanta\ServletExec
ISAPI\webapps\default</em>,
- creating the directory default if required.</li>
-
-<li>Start IIS.</li>
-
-<li>Open the Cocoon welcome page (<span
class="codefrag">http://localhost/cocoon/</span>)</li>
-
-<li>
- Congratulations! (hopefully) you should see the Cocoon welcome
page.
- </li>
-
-</ol>
-</div>
-<a name="N1063D"></a><a
name="Installing+on+JBoss+2.4.4+with+Tomcat+4.0.1+%28Catalina%29"></a>
-<h4>Installing on JBoss 2.4.4 with Tomcat 4.0.1 (Catalina)</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- This section describes the deployment of the Cocoon sample WAR with
- the JBoss-2.4.4_Tomcat-4.0.1 package. It assumes that you built
Cocoon as
- described above or downloaded the binary Cocoon distribution. All
steps have
- been tested with a fresh JBoss 2.4.4 installation on Linux and
Windows 2000.
- </p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">The JBoss/Tomcat bundle is available from the
- <a href="http://sourceforge.net/projects/jboss/";>JBoss project
page</a>
-
-</div>
-</div>
-<p>
- The JBoss/Tomcat package has the following directory structure
- </p>
-<pre class="code">
-[path]/JBoss-2.4.4_Tomcat-4.0.1/jboss
-[path]/JBoss-2.4.4_Tomcat-4.0.1/catalina
-</pre>
-<p>
- Subsequently,
- </p>
-<ul>
-
-<li>
-<span class="codefrag">jboss</span> denotes the <span
class="codefrag">JBoss-2.4.4_Tomcat-4.0.1/jboss</span> directory
- </li>
-
-<li>
-<span class="codefrag">catalina</span> is short for <span
class="codefrag">JBoss-2.4.4_Tomcat-4.0.1/catalina</span>
-</li>
-
-<li>and <span class="codefrag">cocoon</span> is the base directory of your
Cocoon distribution or CVS checkout.</li>
-
-</ul>
-<p>In order to get Cocoon running you have to install Xerces as default XML
parser for JBoss.</p>
-<ul>
-
-<li>Stop JBoss if it is running.</li>
-
-<li>Remove the following files from the <span
class="codefrag">jboss/lib</span> directory
- <ul>
-
-<li>crimson.jar</li>
-
-<li>jaxp.jar</li>
-
-</ul>
-
-</li>
-
-<li>Copy <span class="codefrag">xml-apis.jar</span> from <span
class="codefrag">cocoon/lib/core/</span> to <span
class="codefrag">jboss/lib</span>
-</li>
-
-<li>Change <span class="codefrag">jboss/bin/run.sh</span>
-</li>
-
-</ul>
-<pre class="code">
-[...]
-# Add the XML parser jar and set the JAXP factory names
-# Crimson parser JAXP setup(default)
-<strong># Change it to Xerces for C2</strong>
-JBOSS_CLASSPATH=$JBOSS_CLASSPATH:<strong>../lib/xml-apis.jar</strong>
-<strong># Remove the following two lines</strong>
-JAXP=-Djavax.xml.parsers.DocumentBuilderFactory=\
- org.apache.crimson.jaxp.DocumentBuilderFactoryImpl
-JAXP="$JAXP -Djavax.xml.parsers.SAXParserFactory=\
- org.apache.crimson.jaxp.SAXParserFactoryImpl"
-[...]
-</pre>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Windows users have to change <span
class="codefrag">run.bat</span> accordingly.
- </div>
-</div>
-<ul>
-
-<li>Start JBoss with <span class="codefrag">run_with_catalina.sh</span> or
<span class="codefrag">run_with_catalina.bat</span>
-</li>
-
-<li>Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span> to
<span class="codefrag">jboss/deploy</span>
-</li>
-
-<li>Check the server log to make sure that <span class="codefrag">J2EE
application: [...]/cocoon.war is deployed.</span>
-</li>
-
-<li>Open the Cocoon welcome page (<span
class="codefrag">http://localhost:8080/cocoon/</span>)</li>
-
-<li>You should see the Cocoon welcome page.</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">As both JBoss and Cocoon ship with a Hypersonic
database installed,
- these two conflict and you won't be able to use Cocoon database
(SQL) samples.
- Then again, you probably use JBoss for EJB persistence anyway, so
this shouldn't
- bother you too much ;-)
- </div>
-</div>
-</div>
-<a name="N106D0"></a><a
name="Installing+on+JBoss+2.2.2+with+Tomcat+3.2.2"></a>
-<h4>Installing on JBoss 2.2.2 with Tomcat 3.2.2</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>This section describes the deployment of the Cocoon sample WAR with
- the JBoss 2.2.2/Tomcat-3.2.2 package. It assumes that you built
Cocoon as described above.
- All steps have been tested with a fresh JBoss 2.2.2 installation on
Linux and Windows ME(sic).</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">The JBoss/Tomcat bundle is available from the
- <a href="http://sourceforge.net/projects/jboss/";>JBoss project
page</a>
-
-</div>
-</div>
-<p>The JBoss/Tomcat package has the following directory structure</p>
-<pre class="code">
-[path]/JBoss-2.2.2_Tomcat-3.2.2/jboss
-[path]/JBoss-2.2.2_Tomcat-3.2.2/tomcat
- </pre>
-<p>Subsequently,</p>
-<ul>
-
-<li>
-<span class="codefrag">jboss</span> denotes the <span
class="codefrag">JBoss-2.2.2_Tomcat-3.2.2/jboss</span> directory</li>
-
-<li>
-<span class="codefrag">Tomcat</span> is short for <span
class="codefrag">JBoss-2.2.2_Tomcat-3.2.2/tomcat</span>
-</li>
-<li>and <span class="codefrag">cocoon</span> is the base directory of your
Cocoon distribution or CVS checkout.</li>
-
-</ul>
-<p>In order to get Cocoon running you have to install Xerces as default XML
parser for JBoss.</p>
-<ul>
-
-<li>Stop the server if it is running.</li>
-
-<li>Remove the following files from the <span
class="codefrag">jboss/lib</span> directory
- <ul>
-
-<li>crimson.jar</li>
-
-<li>jaxp.jar</li>
-
-<li>xml.jar</li>
-
-</ul>
-
-</li>
-
-<li>Remove the following files from the <span
class="codefrag">tomcat/lib</span>
- directory
- <ul>
-
-<li>jaxp.jar</li>
-
-<li>parser.jar</li>
-
-</ul>
-
-</li>
-
-<li>Copy <span class="codefrag">xerces-XXX.jar</span> from <span
class="codefrag">cocoon/lib/core/</span> to <span
class="codefrag">jboss/lib</span>
-</li>
-
-<li>Change <span class="codefrag">jboss/bin/run.sh</span>
-</li>
-
-</ul>
-<pre class="code">
-[...]
-# Add the XML parser jars and set the JAXP factory names
-# Crimson parser JAXP setup(default)
-<strong># Change it to Xerces for C2</strong>
-JBOSS_CLASSPATH=$JBOSS_CLASSPATH:<strong>../lib/xerces-XXX.jar</strong>
-<strong># Remove the following two lines</strong>
-JAXP=-Djavax.xml.parsers.DocumentBuilderFactory=\
- org.apache.crimson.jaxp.DocumentBuilderFactoryImpl
-JAXP="$JAXP -Djavax.xml.parsers.SAXParserFactory=\
- org.apache.crimson.jaxp.SAXParserFactoryImpl"
-[...]
- </pre>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Windows users have to change <span
class="codefrag">run.bat</span> accordingly.
- </div>
-</div>
-<ul>
-
-<li>Start JBoss with <span class="codefrag">run_with_tomcat.sh</span> or
<span class="codefrag">run_with_tomcat.bat</span>
-</li>
-
-<li>Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span> to
<span class="codefrag">jboss/deploy</span>
-</li>
-
-<li>Check the server log to make sure that <span class="codefrag">J2EE
application: [...]/cocoon.war is deployed.</span>
-</li>
-
-<li>Open the Cocoon welcome page (<span
class="codefrag">http://localhost:8080/cocoon/</span>)</li>
-
-<li>
- Congratulations! (hopefully) you should see the Cocoon welcome
page.
- </li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">As both JBoss and Cocoon ship with a Hypersonic
database installed, these two conflict and you won't be able to use Cocoon
database (SQL) samples. Then again, you probably use JBoss for EJB persistence
anyway, so this shouldn't bother you too much ;-)
- </div>
-</div>
-</div>
-<a name="N10774"></a><a name="Installing+on+Resin+2.x"></a>
-<h4>Installing on Resin 2.x</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- This section describes the deployment of the Cocoon sample WAR with
Resin 2.x.
- It assumes that you built Cocoon as described above. All steps have
been tested
- with a fresh Resin 2.0.0, 2.0.4, and 2.1.3 installations (the
package is available from
- <a href="http://www.caucho.com/download/";>Resin's download page</a>)
- </p>
-<p>After unpacking the Resin package you get the following directory
structure</p>
-<pre class="code">
-[path]...
-[path]/resin-2.x/conf
-[path]/resin-2.x/lib
-[path]/resin-2.x/webapps
-[path]...</pre>
-<p>To get Cocoon running do the following:</p>
-<ul>
-
-<li>Stop the server if it is running.</li>
-
-
-<li>
-
-<strong>For 2.0.3 version and older:</strong>
- If yours Resin is older then 2.0.4, you have to install Xerces as
default XML parser for Resin
- <ul>
-<li>Remove the following files from the <span
class="codefrag">resin-2.0.x/lib</span> directory:
- <ul>
-
-<li>jaxp.jar</li>
-
-<li>dom.jar</li>
-
-<li>sax.jar</li>
-
-</ul>
-
-</li>
-
-<li>Copy <span class="codefrag">xerces-XXX.jar</span> and <span
class="codefrag">xml-apis.jar</span>
- JAR file from <span
class="codefrag">cocoon-2.1/lib/core/</span> to
- the <span class="codefrag">resin-2.0.x/lib/</span>
directory.</li>
-
-</ul>
-
-</li>
-
-
-<li>
-
-<strong>For 2.0.4 version and newer:</strong>
- Edit <span class="codefrag">resin-2.x/conf/resin.conf</span>,
change value of the
- <span class="codefrag">servlet-classloader-hack</span> element to
<span class="codefrag">true</span>
-
-</li>
-
-
-<li>Copy the <span
class="codefrag">cocoon-2.1/build/cocoon/cocoon.war</span> WAR file to <span
class="codefrag">resin-2.x/webapps</span> directory
- </li>
-
-<li>Start Resin as usual</li>
-
-<li>Open the Cocoon welcome page (<span
class="codefrag">http://localhost:8080/cocoon/</span>)</li>
-
-<li>Congratulations! (hopefully) you should see the Cocoon welcome page.</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content"> If you want to place Cocoon webapp in a
- directory different than <span
class="codefrag">resin-2.x/webapps</span>, you need
- to edit <span class="codefrag">resin-2.x/conf/resin.conf</span> file
and add a line
- somewhere in <span class="codefrag"><host></span> tag:
- <span class="codefrag"><web-app id='/cocoon'
app-dir='/path/to/webapp/cocoon.war'/></span>
-
-</div>
-</div>
-</div>
-<a name="N107EE"></a><a name="Installing+on+HP-AS+8.X"></a>
-<h4>Installing on HP-AS 8.X</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>HP-AS is J2EE application server available from the Hewlett-Packard
website.
- <a href="http://www.hpmiddleware.com/download";>Download and install
HP-AS 8.X</a>
-
-</p>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Cocoon cannot be deployed as a .war file in HP-AS.
- Use the following steps to deploy cocoon.war:
- </div>
-</div>
-<ol>
-
-<li>Extract the <span class="codefrag">cocoon.war</span> file to some
directory, using <span class="codefrag">WinZIP</span>
- or a similar utility to extract the files.</li>
-
-<li>To run HP-AS, go to<strong><span class="codefrag">( Start | Programs |
HP Middleware | HP Application Server | System Console).</span></strong>
-
-<br>
- The HP-AS Console appears with a Log browser.
- As the HP-AS kernel starts and initializes, messages will appear
in the
- status bar of the console.
- Wait for the message 'Kernel started' to appear in the Log
browser.
- The following message should display:<br>
-<br>
-
-<span class="codefrag">[10/16/01 16:03:50][localhost_][S]:Kernel "kernel"
started.</span>
-<br>
-<br>
-
-</li>
-
-<li>To verify that an instance of HP-AS is running,
- open a web browser and go to <span
class="codefrag">http://localhost:9090/helloservlet/hello</span>
-
-<br>
- An HTML page should appear containing the following message:
- <br>
-<br>
-
-<span class="codefrag">Congratulations!</span>
-<br>
-
-<span class="codefrag">Congratulations from the HelloWorldServlet</span>
-<br>
-
-<span class="codefrag">It appears you have the server running</span>
-<br>
-
-<span class="codefrag">My servlet path is /hello</span>
-<br>
-<br>
-
-<strong><span class="codefrag">This test is valid only if you've performed a
full install of HP-AS</span></strong>
-
-<br>
-<br>
-
-</li>
-
-<li>In the HP-AS console, select <strong>View | Deployment Window</strong>.
- In the <strong>Available Files</strong> pane on the right,
- browse to the the directory you extracted the <span
class="codefrag">cocoon.war</span> file to.
- <br>
- Expand this directory, and then drag and drop the
- <span class="codefrag">cocoon</span> sub-directory node to the
<strong>kernel.j2ee-partition</strong> icon
- in the left pane.
- </li>
-
-<li>When prompted, answer <strong>Yes</strong> to the deployment
question.<br>
- This should create an appropriate entry in the HP-AS j2ee
partition configuration file.<br>
-
-<strong><span class="codefrag">In the current version of the console,
- there is no indication that the operation succeeded.
- If you see a parser error in the Log browser, ignore
it.</span></strong>
-
-</li>
-
-<li>To test the deployment, open a web browser and go to the following
URL:<br>
-<br>
-
-<span class="codefrag">http://localhost:9090/cocoon/welcome</span>
-
-<br>
-<br>
- Congratulations! (hopefully) you should see the Cocoon welcome
page.
- (this request may take some time).
- <br>
-
-</li>
-
-</ol>
-</div>
-<a name="N1086E"></a><a name="Installing+on+JRun+3.1"></a>
-<h4>Installing on JRun 3.1</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- This section describes the deployment of the Cocoon sample WAR
with JRun 3.1,
- on its default server. It assumes that you built Cocoon as
described above. All
- steps have been tested under Win2000.
- </p>
-<p>To get Cocoon running do the following:</p>
-<ul>
-
-<li>Stop the default and admin servers if they are running.</li>
-
-<li>Remove <span class="codefrag">jaxp.jar</span> and <span
class="codefrag">parser.jar</span>
- files (Crimson XML parser) from the <span
class="codefrag">jrun/lib/ext/</span> directory.
- </li>
-
-<li>Install Xerces as default XML parser for JRun by copying
- <span class="codefrag">xerces-XXX.jar</span> and <span
class="codefrag">xml-apis.jar</span> JAR
- files from the <span
class="codefrag">cocoon-2.1/lib/core/</span> to <span
class="codefrag">jrun/lib/ext/</span>
- directory.
- </li>
-
-<li>Update Rhino shipped with JRun with newer version from the Cocoon by
- overwriting <span class="codefrag">jrun/lib/rhino.jar</span> JAR
file
- with the <span
class="codefrag">cocoon-2.1/lib/optional/rhino-1.5r3.jar</span> file.
- </li>
-
-<li>Start JRun admin server.</li>
-
-<li>Start JRun default server.</li>
-
-<li>Open JRun admin page:
- <span class="codefrag">http://localhost:8000/</span>
-
-</li>
-
-<li>Deploy cocoon.war webapp using console. Use same values for
- application name and URI prefix (e.g., application name "cocoon",
- URI "/cocoon").</li>
-
-<li>Open the Cocoon welcome page:
- <span class="codefrag">http://localhost:8100/cocoon/</span>
-
-</li>
-
-<li>Congratulations! (hopefully) you should see the Cocoon welcome page.</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">Instead of deploying WAR file using console, same could
be done by copying
- <span class="codefrag">cocoon-2.1/build/cocoon/webapp</span> under
<span class="codefrag">jrun/servers/default/</span>
- directory and adding following lines to the <span
class="codefrag">jrun/servers/default/local.properties</span>:
- </div>
-</div>
-<pre class="code">
-cocoon.rootdir=/absolute/path/to/jrun/servers/default/cocoon
-cocoon.class={webapp.service-class}
-webapp.mapping./cocoon=cocoon</pre>
-</div>
-<a name="N108CD"></a><a
name="Installing+on+iPlanet+Web+Server+4.x+and+other+engines+without+context+management"></a>
-<h4>Installing on iPlanet Web Server 4.x and other engines without context
management</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- iPlanet Web Server 4.x provides the servlet 2.2 API (<span
class="codefrag">javax.servlet.*</span> classes),
- but the servlet engine doesn't handle servlet contexts. This means
there is no classloader
- built with the contents of <span
class="codefrag">WEB-INF/classes</span> and <span
class="codefrag">WEB-INF/lib</span> and that
- resolution of context resources (using <span
class="codefrag">ServletContext.getResource()</span>) doesn't give
- the expected results.
- </p>
-<p>
- To be able to run on such non-compliant engines, Cocoon provides a
bootstrap servlet in
- <span
class="codefrag">org.apache.cocoon.BootstrapServlet</span>that handles all the
servlet context related
- behaviours needed for proper functioning.
- </p>
-<p>
- To use this bootstrap servlet, configure your servlet engine as
follows (how to do it depends
- on the actual engine - see below for iPlanet) :
- </p>
-<ul>
-
-<li>add cocoon.jar (and only this one) in the engine's classpath,</li>
-
-<li>declare the <span
class="codefrag">org.apache.cocoon.servlet.BootstrapServlet</span> servlet,</li>
-
-<li>add a "<span class="codefrag">context-directory</span>" parameter, whose
value is the absolute path to Cocoon's
- context (e.g. "<span
class="codefrag">/path/webapp/cocoon</span>"),</li>
-
-<li>add any other cocoon parameters you want to this servlet (see <span
class="codefrag">web.xml</span> for a
- description of available parameters),</li>
-
-<li>configure a path translation from "/" to the servlet.</li>
-
-</ul>
-<p>For iPlanet Web Server 4.x, this translates to :</p>
-<ul>
-
-<li>connect to the administration server of your web server,</li>
-
-<li>in the "Servlet" tabs, select "Configure servlet attributes", and enter
the following :
- <ul>
-
-<li>Servlet Name : <span class="codefrag">cocoon</span>
-</li>
-
-<li>Servlet Code (class name) : <span
class="codefrag">org.apache.cocoon.servlet.BootstrapServlet</span>
-</li>
-
-<li>Servlet Classpath : <span
class="codefrag">/path/webapp/cocoon/WEB-INF/lib/cocoon.jar</span>
-</li>
-
-<li>Servlet Args : <span
class="codefrag">context-directory=/path/webapp/cocoon</span> (and any other
Cocoon
- parameters you want)</li>
-
-</ul>
-
-</li>
-
-<li>select "Configure Servlet Virtual Path Translation" and enter the
following :
- <ul>
-
-<li>Virtual Path : <span class="codefrag">@/.*</span>
-</li>
-
-<li>Servlet Name : <span class="codefrag">cocoon</span>
-</li>
-
-</ul>
-
-</li>
-
-<li>save and apply your changes, and enjoy the latest Cocoon on an
old-fashioned servlet engine !</li>
-
-</ul>
-</div>
-<a name="N10940"></a><a name="Installing+on+WebSphere+4.0"></a>
-<h4>Installing on WebSphere 4.0</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- This section describes the deployment of the Cocoon sample WAR
with WebSphere 4.0,
- on its default server. It assumes that you built Cocoon as
described above. All
- steps have been tested under Win2000 and WebSphere AEs 4.0.1
a0136.02.
- </p>
-<p>To get Cocoon running do the following:</p>
-<ul>
-
-<li>Start the server using <span class="codefrag">startServer</span> startup
script.</li>
-
-<li>Open admin page:
- <span class="codefrag">http://localhost:9090/admin/</span>
-
-</li>
-
-<li>Deploy cocoon.war webapp using console.</li>
-
-<li>Save server configuration file.</li>
-
-<li>Restart the server using <span class="codefrag">stopServer</span> and
- <span class="codefrag">startServer</span> scripts.</li>
-
-<li>Open the Cocoon welcome page:
- <span class="codefrag">http://localhost:9080/cocoon/</span>
-
-</li>
-
-<li>Congratulations! (hopefully) you should see the Cocoon welcome page.</li>
-
-</ul>
-<div class="frame note">
-<div class="label">Note</div>
-<div class="content">WebSphere power users might deploy Cocoon by exploding
cocoon.war into
- <span class="codefrag">installedApps</span> directory and editing
- <span class="codefrag">config/server-cfg.xml</span> file.
- </div>
-</div>
-</div>
-</div>
-
-</div>
-</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end Content==================-->
-</table>
-</td>
-</tr>
-</table>
-<!--================= end Menu, NavBar, Content ==================-->
-<!--================= start Footer ==================-->
-<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
-<tr>
-<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="../skin/images/spacer.gif"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
-</tr>
-<tr>
-<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
- 1999-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
- document.write(" - "+"Last Published: " +
document.lastModified);
- // --></script></font></td>
-</tr>
-<tr>
-<td colspan="2" align="left" bgcolor="#CFDCED" class="logos">
-<div>
-<a href="http://validator.w3.org/check/referer";><img width="88" height="31"
alt="Valid HTML 4.01!" src="../skin/images/valid-html401.png" class="logoImage"
border="0"></a><a href="http://jigsaw.w3.org/css-validator/";><img width="88"
height="31" alt="Valid CSS!" src="../skin/images/vcss.png" class="logoImage"
border="0"></a><img alt="" height="1" width="10"
src="../skin/images/spacer.gif"><a href="http://xml.apache.org/forrest/";><img
border="0" alt="Built with Apache Forrest logo"
src="../images/built-with-forrest-button.png" width="88" height="31"><img
height="1" width="5" alt="" border="0" src="../skin/images/spacer.gif"></a>
-</div>
-</td>
-</tr>
-</table>
-<!--================= end Footer ==================-->
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Installing Apache Cocoon</title>
+<link type="text/css" href="../skin/page.css" rel="stylesheet">
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<!--================= start Navigation Path ==================-->
+<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font
size="2" face="Arial, Helvetica, Sans-serif"><script
src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Navigation Path ==================-->
+<!--================= start Banner ==================-->
+<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<!--================= start Group Logo ==================-->
+<td bgcolor="#294563"><a href=""></a></td>
+<!--================= end Group Logo ==================-->
+<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache
Cocoon" src="../images/project-logo.gif"></a></td>
+<!--================= end Project Logo ==================-->
+<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
+<form target="_blank" action="http://www.google.com/search"; method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
+<tr>
+<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"
class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org"
name="sitesearch" type="hidden"><input size="15" name="q" id="query"
type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><input name="Search" value="Search" type="submit">
+<br>
+<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
+ the Apache Cocoon site
+
+
+ </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0"
height="10" width="9" src="../skin/images/search-right.gif"></td>
+</tr>
+</table>
+</form>
+</td>
+<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" bgcolor="#294563" colspan="2">
+<!--================= start Tabs ==================-->
+<div class="tab">
+<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td width="6"><img alt="" height="8" width="6"
src="../skin/images/spacer.gif"></td><td valign="bottom">
+<table summary="selected tab" style="height: 1.8em" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a href="../index.html"><font
color="#000000">Home</font></a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</div>
+<!--================= end Tabs ==================-->
+</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Banner ==================-->
+<!--================= start Menu, NavBar, Content ==================-->
+<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top">
+<table summary="menu" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<!--================= start left top NavBar ==================-->
+<td rowspan="3" valign="top">
+<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
+</tr>
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td>
+<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom"
bgcolor="#4C6C8F"><img width="10" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"
valign="top" bgcolor="#4C6C8F">
+<!--================= start Menu items ==================-->
+<div class="menu">
+<ul>
+<li>
+<font color="#CFDCED">Navigation</font>
+<ul>
+
+<li>
+<a href="../index.html">Main</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Installation</font>
+<ul>
+
+<li>
+<a target="_blank" href="http://cocoon.apache.org/mirror.cgi";>Download</a>
+</li>
+
+<li>
+<span class="sel"><font color="#ffcc00">Installing</font></span>
+</li>
+
+<li>
+<a href="updating.html">Updating</a>
+</li>
+
+<li>
+<a href="jars.html">Jars</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Testing</font>
+<ul>
+
+<li>
+<a href="tests.html">Overview</a>
+</li>
+
+</ul>
+</li>
+</ul>
+</div>
+<!--================= end Menu items ==================-->
+</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
+</tr>
+<tr>
+<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td><td valign="top" width="100%">
+<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<!--================= start middle NavBar ==================-->
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="right"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td width="10"
bgcolor="#CFDCED"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end middle NavBar ==================-->
+<!--================= start Content==================-->
+<tr>
+<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="100%">
+<div class="content">
+<table class="title" summary="">
+<tr>
+<td valign="middle">
+<h1>Installing Apache Cocoon</h1>
+</td><script Language="Javascript">
+
+function printit(){
+if (window.print) {
+ window.print() ;
+} else {
+ var WebBrowser = '<OBJECT
CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0"
ID="WebBrowser1"></OBJECT>';
+document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
+ WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box
WebBrowser1.outerHTML = "";
+}
+}
+</script><script Language="Javascript">
+var NS = (navigator.appName == "Netscape");
+var VERSION = parseInt(navigator.appVersion);
+if (VERSION > 3) {
+ document.write('<td nowrap="nowrap" width="40" align="center">');
+ document.write(' <a class="dida" href="javascript:printit()">');
+ document.write(' <img alt="Print this Page"
src="../skin/images/printer.gif" class="skin"><br>');
+ document.write(' print</a>');
+ document.write('</td>');
+}
+</script><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="index.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
class="skin"><br>
+ PDF</a></td>
+</tr>
+</table>
+<p>
+<font size="-2">by Stefano Mazzocchi, Giacomo Pati, Tom
Klaasen, Chris Stevenson, Carsten Ziegeler, Vadim
Gritsenko, Bernhard Huber, Nicola Ken Barozzi, Sylvain
Wallez</font>
+</p>
+<ul class="minitoc">
+<li>
+<a href="#System+Requirements">System Requirements</a>
+</li>
+<li>
+<a href="#Getting+Apache+Cocoon">Getting Apache Cocoon</a>
+<ul class="minitoc">
+<li>
+<a href="#Download+a+distribution">Download a distribution</a>
+</li>
+<li>
+<a href="#Download+a+development+snapshot">Download a development
snapshot</a>
+</li>
+<li>
+<a href="#Step-by-step+cvs+instructions+for+Windows">Step-by-step cvs
instructions for Windows</a>
+</li>
+<li>
+<a href="#Step-by-step+cvs+instructions+for+Unix">Step-by-step cvs
instructions for Unix</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Configuring+Environment">Configuring Environment</a>
+<ul class="minitoc">
+<li>
+<a href="#Set+JAVA_HOME+environment+variable">Set JAVA_HOME environment
variable</a>
+</li>
+<li>
+<a href="#Java+1.4+configuration">Java 1.4 configuration</a>
+</li>
+<li>
+<a href="#JDK+Dependency">JDK Dependency</a>
+</li>
+<li>
+<a href="#UNIX+with+X+server">UNIX with X server</a>
+</li>
+<li>
+<a href="#Headless+UNIX+and+PJA">Headless UNIX and PJA</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Building+Cocoon">Building Cocoon</a>
+<ul class="minitoc">
+<li>
+<a href="#Optional+functionality">Optional functionality</a>
+</li>
+<li>
+<a href="#Running+the+build">Running the build</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Installing+Cocoon">Installing Cocoon</a>
+<ul class="minitoc">
+<li>
+<a href="#Installing+on+Tomcat+3.3.X">Installing on Tomcat 3.3.X</a>
+</li>
+<li>
+<a href="#Installing+on+Tomcat+3.2.X">Installing on Tomcat 3.2.X</a>
+</li>
+<li>
+<a href="#Installing+on+Tomcat+4.0+-+4.0.1%2C+4.0.4b1">Installing on Tomcat
4.0 - 4.0.1, 4.0.4b1</a>
+</li>
+<li>
+<a href="#Installing+on+Tomcat+4.0.3">Installing on Tomcat 4.0.3</a>
+</li>
+<li>
+<a href="#Installing+on+Tomcat+4.0.4b1+LE+with+JDK+1.4.0">Installing on
Tomcat 4.0.4b1 LE with JDK 1.4.0</a>
+</li>
+<li>
+<a href="#Installing+on+BEA+Weblogic+6.0sp2">Installing on BEA Weblogic
6.0sp2</a>
+</li>
+<li>
+<a
href="#Installing+on+ServletExec+3.1+%28In+Process+with+IIS%29">Installing on
ServletExec 3.1 (In Process with IIS)</a>
+</li>
+<li>
+<a
href="#Installing+on+JBoss+2.4.4+with+Tomcat+4.0.1+%28Catalina%29">Installing
on JBoss 2.4.4 with Tomcat 4.0.1 (Catalina)</a>
+</li>
+<li>
+<a href="#Installing+on+JBoss+2.2.2+with+Tomcat+3.2.2">Installing on JBoss
2.2.2 with Tomcat 3.2.2</a>
+</li>
+<li>
+<a href="#Installing+on+Resin+2.x">Installing on Resin 2.x</a>
+</li>
+<li>
+<a href="#Installing+on+HP-AS+8.X">Installing on HP-AS 8.X</a>
+</li>
+<li>
+<a href="#Installing+on+JRun+3.1">Installing on JRun 3.1</a>
+</li>
+<li>
+<a
href="#Installing+on+iPlanet+Web+Server+4.x+and+other+engines+without+context+management">Installing
on iPlanet Web Server 4.x and other engines without context management</a>
+</li>
+<li>
+<a href="#Installing+on+WebSphere+4.0">Installing on WebSphere 4.0</a>
+</li>
+</ul>
+</li>
+</ul>
+
+<a name="N10034"></a><a name="System+Requirements"></a>
+<h3>System Requirements</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ Apache Cocoon requires the following systems to be already installed
in your system:
+ </p>
+<p>
+<strong>Java Virtual Machine</strong>
+ A Java 1.3 or later compatible virtual machine must be present for
both
+ command line and servlet type usage of Apache Cocoon. Note that all
servlet engines
+ require a JVM to run so if you are already using servlets you already
have
+ one installed.
+ </p>
+<p>
+<strong>Servlet Engine</strong>
+ A Servlet 2.2 compliant servlet engine must be present in order to
support
+ servlet operation and dynamic request handling. Note that this
requirement
+ is optional for command line operation. Note also that Cocoon now
ships
+ with a stripped down version of Jetty suitable for immediately
testing
+ with no further downloads.
+ </p>
+<p>When the time comes to run your Cocoon application in a full featured
+ servlet container, you may want to consider the following Open Source
+ options:</p>
+<ol>
+
+<li>The Apache Tomcat project
+ <a
href="http://jakarta.apache.org/tomcat/";>http://jakarta.apache.org/tomcat/</a>
+
+</li>
+
+<li>The full version of Jetty
+ <a
href="http://jetty.mortbay.org/";>http://jetty.mortbay.org/</a>
+
+</li>
+
+</ol>
+</div>
+
+
+<a name="N1005B"></a><a name="Getting+Apache+Cocoon"></a>
+<h3>Getting Apache Cocoon</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ You have three choices for getting Cocoon: you can either download
+ a stable release, or you can download development snapshot, or you can
+ get the latest development version directly from the cvs repository.
+ </p>
+<a name="N10063"></a><a name="Download+a+distribution"></a>
+<h4>Download a distribution</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ You can simply download the latest official release from the
+ <a href="http://cocoon.apache.org/mirror.cgi";>Cocoon distribution</a>
+ directory.
+ </p>
+</div>
+<a name="N10070"></a><a name="Download+a+development+snapshot"></a>
+<h4>Download a development snapshot</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ You also can download one of the development snapshots from the
+ <a href="http://xml.apache.org/cocoon/mirror.cgi#nightly";>CVS
snapshots</a>
+ directory.
+ </p>
+</div>
+<a name="N1007D"></a><a name="Step-by-step+cvs+instructions+for+Windows"></a>
+<h4>Step-by-step cvs instructions for Windows</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>See the Cocoon document
+ <a
href="http://cocoon.apache.org/community/contrib.html";>Contrib</a>
+ for starting tips.
+ </p>
+<ol>
+
+<li>Download
+ <a
href="http://telia.dl.sourceforge.net/cvsgui/WinCvs120.zip";>WinCVS
+ (v1.2)</a> (homepage is <a
href="http://www.wincvs.org/";>http://www.wincvs.org/</a>);
+ </li>
+
+<li>Install it;</li>
+
+<li>Start it;</li>
+
+<li>Click on admin->preferences;</li>
+
+<li> In "Enter the CVSROOT:" enter
+ ":pserver:[EMAIL PROTECTED]:/home/cvspublic" (without
quotes);</li>
+
+<li>In "Authentication:" choose ""passwd" file on the cvs server";</li>
+
+<li>Click "Ok";</li>
+
+<li>Click admin->login;</li>
+
+<li> When asked for the password: answer "anoncvs" (without quotes);</li>
+
+<li> Click "create->checkout module";</li>
+
+<li>Module name and path on the server is "cocoon-2.1" (no quotes);</li>
+
+<li>Choose a dir to put the source code in;</li>
+
+<li>Go to the "Checkout-options" tab and select "By revision/tag/branch"
+ and enter "HEAD";</li>
+
+<li>Click "Ok";</li>
+
+<li>If everything goes well, messages will start to appear in the log
+ window;</li>
+
+<li>Wait until you see "*****CVS exited normally with code 0*****" in the
+ log window;</li>
+
+<li>The Cocoon source is now on your harddrive.</li>
+
+</ol>
+</div>
+<a name="N100C8"></a><a name="Step-by-step+cvs+instructions+for+Unix"></a>
+<h4>Step-by-step cvs instructions for Unix</h4>
+<div style="margin-left: 0 ; border: 2px">
+<ol>
+
+<li>Start the shell of your choice.</li>
+
+<li>Enter "cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login".</li>
+
+<li>When asked for the password: answer "anoncvs".</li>
+
+<li>Enter "cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic -z3 checkout
+ -r HEAD cocoon-2.1". This will create a directory called
"cocoon-2.1" where the
+ Cocoon2 source will be stored.</li>
+
+<li>Wait until cvs has finished.</li>
+
+<li>The Cocoon source is now on your harddrive.</li>
+
+</ol>
+<p>In case you want to update your Cocoon source tree to the
+ current version, change to the "cocoon-2.1" directory and
+ call "cvs -z3 update -d -P".</p>
+</div>
+</div>
+
+
+<a name="N100E7"></a><a name="Configuring+Environment"></a>
+<h3>Configuring Environment</h3>
+<div style="margin-left: 0 ; border: 2px">
+<a name="N100EC"></a><a name="Set+JAVA_HOME+environment+variable"></a>
+<h4>Set JAVA_HOME environment variable</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Set the JAVA_HOME environment variable to point to the root directory of
+ the Java Development Kit installed on your machine. To do this
simply type:</p>
+<pre class="code">
+[unix] JAVA_HOME=/path/to/java/
+[win32] SET JAVA_HOME=c:\path\to\java</pre>
+<p>Your mileage may vary, but you know how to setup environments, right?</p>
+</div>
+<a name="N100FD"></a><a name="Java+1.4+configuration"></a>
+<h4>Java 1.4 configuration</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Cocoon requires more recent versions of the Xerces and Xalan libraries
+ than those shipped with j2se 1.4. To override bundled libraries,
follow
+ these steps:
+ </p>
+<ol>
+
+<li>
+ Create <span
class="codefrag">%JAVA_HOME%\jre\lib\endorsed</span> directory. (Tomcat users
+ use <span class="codefrag">%TOMCAT_HOME\common\endorsed</span>
instead)
+ </li>
+
+<li>
+ Copy <span class="codefrag">xercesXXX.jar</span>, <span
class="codefrag">xalan-XXX.jar</span>,
+ and the <span class="codefrag">xml-apis.jar</span> from the
+ <span class="codefrag">.\lib\endorsed\</span> to the new
directory created above.
+ </li>
+
+</ol>
+<p>Due to changes in JDBC between JDK 1.3 and JDK 1.4, it is not possible
+ to use Cocoon built on JDK 1.3 with JDK 1.4 when it comes to
database
+ connections. Make sure you prepare cocoon with a JDK that
matches the
+ one you will deploy on.
+ </p>
+</div>
+<a name="N10124"></a><a name="JDK+Dependency"></a>
+<h4>JDK Dependency</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Cocoon requires a Java compiler for installation and for running some
+ components like XSP etc. For components, the default
configuration of
+ Cocoon does not use the compiler in JAVA_HOME, but a version
shipped
+ with Cocoon.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">You can configure which compiler Cocoon uses in
WEB-INF/lib.
+ </div>
+</div>
+</div>
+<div class="frame fixme">
+<div class="label">Fixme (
+ ghoward
+
+ )</div>
+<div class="content">Is this still an issue?</div>
+</div>
+<a name="N10134"></a><a name="UNIX+with+X+server"></a>
+<h4>UNIX with X server</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Cocoon is bundled with the <a
href="http://xml.apache.org/batik/";>Batik</a>
+ (SVG rasterization toolkit) to deliver SVG imaging capabilities.
Batik uses Java
+ <span class="codefrag">java.awt</span> library, which (at least in
Sun JDK before 1.4) requires
+ graphics display. This means that X server must be running and
Cocoon should
+ have permission to connect to it.</p>
+<p>Easiest way to avoid X server connection problem (and to have mentioned
permission)
+ is to install and run Cocoon and entire servlet engine of your
choice under regular
+ user account.</p>
+<p>For security, and many other reasons, X server can be replaced by Xfvb
+ or PJA (alternative awt implementation).</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Sun JDK 1.4 does not require graphics display anymore,
but Java has to be
+ started with the argument <span
class="codefrag">-Djava.awt.headless=true</span>,
+ and X libraries still must be installed.</div>
+</div>
+</div>
+<div class="frame fixme">
+<div class="label">Fixme (
+ ghoward
+
+ )</div>
+<div class="content">Is this still an issue?</div>
+</div>
+<a name="N10154"></a><a name="Headless+UNIX+and+PJA"></a>
+<h4>Headless UNIX and PJA</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>If you are using unix with the Sun JDK 1.4, it can run in the
+ headless environment (but you still must have X libraries
installed!)
+ when following option is provided on Java startup:</p>
+<pre class="code">-Djava.awt.headless=true</pre>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">If you use Tomcat, this can be done by setting
environment variable
+ CATALINA_OPTS (Tomcat 4.x), or TOMCAT_OPTS (Tomcat 3.x):</div>
+</div>
+<pre class="code">export CATALINA_OPTS='-Djava.awt.headless=true'</pre>
+<p>If you are using unix with the Sun JDK 1.3.1 or earlier, it's awt
+ implementation requires you to use X even if you aren't actually
+ displaying anything. One simple solution is to use a different
+ implementation of the awt.</p>
+<ol>
+
+<li>From www.eteks.com you can get an awt replacement that doesn't need X:
+ <a
href="http://www.eteks.com/pja/en/";>http://www.eteks.com/pja/en/</a>.</li>
+
+<li>Then add the following options to the Java command starting your
container:
+ </li>
+
+</ol>
+<pre class="code">
+-Xbootclasspath/a:/path/to/pja.jar
+-Dawt.toolkit=com.eteks.awt.PJAToolkit
+-Djava.awt.graphicsenv=com.eteks.java2d.PJAGraphicsEnvironment
+-Djava.awt.fonts=/usr/local/jdk/jre/lib/fonts/</pre>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">If you use Tomcat, this can be done by setting
environment variable
+ CATALINA_OPTS (Tomcat 4.x), or TOMCAT_OPTS (Tomcat 3.x):</div>
+</div>
+<pre class="code">
+export CATALINA_OPTS='-Xbootclasspath/a:/path/to/pja.jar \
+ -Dawt.toolkit=com.eteks.awt.PJAToolkit \
+ -Djava.awt.graphicsenv=com.eteks.java2d.PJAGraphicsEnvironment \
+ -Djava.awt.fonts=/usr/local/jdk/jre/lib/fonts/'</pre>
+</div>
+</div>
+
+
+<a name="N10188"></a><a name="Building+Cocoon"></a>
+<h3>Building Cocoon</h3>
+<div style="margin-left: 0 ; border: 2px">
+<a name="N10191"></a><a name="Optional+functionality"></a>
+<h4>Optional functionality</h4>
+<div style="margin-left: 0 ; border: 2px">
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">This is an area that has changed significantly since
2.0</div>
+</div>
+<a name="N10199"></a><a name="Blocks"></a>
+<h5>Blocks</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>Additional "components" in Cocoon 2.1 are now implemented using a partial
+ implementation of a concept called "blocks". Full support (planned for
the
+ next release) will include hot-deployable services with java-like
extension
+ and inheritance. For this release, blocks are implemented as self
contained
+ units of code, samples, files and configuration. Most, if not all
optional
+ features have been factored out into blocks and can be neatly included
or
+ excluded as a unit.
+ </p>
+<p>Most blocks are configured by default to be included in the build, but
can
+ be excluded using a <span
class="codefrag">local.blocks.properties</span> file.</p>
+<p>
+ Some blocks delivered with Cocoon require additional libraries which
can not
+ be redistributed with Cocoon (e.g. the Php block) the documentation
for
+ these should provide more information, and you should find a "mocks"
directory
+ containing non-functional code provided merely to allow compilation.
+ </p>
+</div>
+<a name="N101AB"></a><a name="Optional+Jars"></a>
+<h5>Optional Jars</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>Some additional libraries could not be factored out
+ into a block. For example, the Jakarta Commons HttpClient jar is used
by
+ several different optional components, some not in blocks. If you
determine
+ that one of these is not necessary for your build, you can eliminate it
from
+ your build by removing its entry in lib/jars.xml and removing the jar
from
+ lib/optional.</p>
+</div>
+<a name="N101B4"></a><a name="Building+a+minimal+Cocoon"></a>
+<h5>Building a minimal Cocoon</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>By creating and editing local.build.properties and
local.blocks.properties you
+ can remove any unnecessary features you desire.
+ </p>
+</div>
+</div>
+<a name="N101BE"></a><a name="Running+the+build"></a>
+<h4>Running the build</h4>
+<div style="margin-left: 0 ; border: 2px">
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">This is an area that has changed significantly since
2.0</div>
+</div>
+<p>Cocoon uses <a href="http://jakarta.apache.org/ant/";>Jakarta Ant</a>
+ for the build and installation, and comes with a build script
+ ([unix]./build.sh, [win32] .\build.bat) that automates the process.</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">If you want to use build.xml directly with your copy of
Ant, please
+ run the build script at least once after every CVS checkout, to ensure
that
+ extra initializations like jar copying are done correctly.</div>
+</div>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The build script overrides the existing ANT_HOME
variable.</div>
+</div>
+<p>There are basically two options that can be set as parameters to
+ the script: <strong>targets</strong> and
<strong>properties</strong>.</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The use of -D style properties as parameters to the
build is deprecated.
+ Use the build and blocks properties files instead.</div>
+</div>
+<a name="N101DF"></a><a name="About+build+targets"></a>
+<h5>About build targets</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>Targets are the execution units available in
+ <a href="http://jakarta.apache.org/ant/";>Ant</a> build files.</p>
+<p>Targets are specified by appending them to
+ the script invocation:</p>
+<pre class="code">
+[unix] ./build.sh target1 target2 ...
+[win32] .\build.bat target1 target2 ...</pre>
+</div>
+<a name="N101F4"></a><a name="Cocoon+build+targets"></a>
+<h5>Cocoon build targets</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>The <strong>build.xml</strong> file comes with some basic
+ important targets. If no target is specified, the default one
+ is used (defined in build.xml).</p>
+<p>Cocoon targets place work files and results in a build directory
+ under the cocoon root. The only exception are the distribution
targets
+ that build in a directory called dist.</p>
+<p>The key targets you will use most often are noted below. For a listing
+ of all available targets, run:</p>
+<pre class="code">
+[unix] ./build.sh -projecthelp
+[win32] .\build.bat -projecthelp</pre>
+<a name="N1020C"></a><a name="build+clean"></a>
+<h6>build clean</h6>
+<div style="margin-left: 0 ; border: 2px">
+<p>Cleans the build directory. It is recommended to clean Cocoon
+ build directory every time you upgrade Cocoon, or add/remove
+ libraries from the <span class="codefrag">./lib/optional/</span>
+ directory, or change JDK version.
+ </p>
+</div>
+<a name="N10218"></a><a name="build+webapp+%5Bdefault%5D"></a>
+<h6>build webapp [default]</h6>
+<div style="margin-left: 0 ; border: 2px">
+<p>Builds a Cocoon web application in build/webapp. This is the default
target, so
+ running the build script with no arguments calls this target.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">For quick testing, a stripped down version of Jetty is
included in the
+ distribution. After a <span class="codefrag">build webapp</span>
<span class="codefrag">cocoon servlet</span>
+ will launch Jetty and Cocoon will be available at
http://localhost:8888/</div>
+</div>
+</div>
+<a name="N1022A"></a><a name="build+war"></a>
+<h6>build war</h6>
+<div style="margin-left: 0 ; border: 2px">
+<p>Builds a Cocoon web application in build/webapp and packages it as a .war
file.
+ </p>
+</div>
+</div>
+</div>
+</div>
+
+
+<a name="N10236"></a><a name="Installing+Cocoon"></a>
+<h3>Installing Cocoon</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>In most servlet engines, this is just a matter of copying
+ the war file or webapp directory to a specific directory and the
+ engine will take care of installing it when restarted.</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">If you are using JDK 1.4, be sure you have read and
followed the
+ "Java 1.4 configuration" information above.</div>
+</div>
+<p>If those simple instructions do not work as expected, you may find
+ help in some of the container-specific notes below contributed by
+ users:</p>
+<a name="N10248"></a><a name="Installing+on+Tomcat+3.3.X"></a>
+<h4>Installing on Tomcat 3.3.X</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>This is a very easy installation.</p>
+<ol>
+
+<li>
+ Build the Cocoon webapp as described above.
+ </li>
+
+
+<li>
+ Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span>
+ into <span class="codefrag">tomcat/webapps</span> directory.
+ </li>
+
+
+<li>
+ Start Tomcat: Go to the <span class="codefrag">tomcat/bin</span>
directory,
+ and run the startup script.
+ </li>
+
+
+<li>
+ Open the Cocoon welcome page:
+ <span class="codefrag">http://localhost:8080/cocoon/</span>
+
+</li>
+
+
+<li>
+ Congratulations! You should see the Cocoon welcome page.
+ </li>
+
+</ol>
+</div>
+<a name="N1026F"></a><a name="Installing+on+Tomcat+3.2.X"></a>
+<h4>Installing on Tomcat 3.2.X</h4>
+<div style="margin-left: 0 ; border: 2px">
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Cocoon requires Tomcat version 3.2 or greater. It
wouldn't work
+ with Tomcat 3.1.X</div>
+</div>
+<p>Tomcat currently uses a different version of the XML parser
+ than Cocoon. To get Cocoon to work, you need to perform the
+ following steps:</p>
+<ol>
+
+
+<li>
+
+<strong>Stop Tomcat</strong>
+ Go to the tomcat/bin directory, and run the shutdown script.
+ </li>
+
+
+<li>
+
+<strong>Delete tomcat/lib/jaxp.jar</strong>
+ Tomcat's jaxp.jar is 'sealed', and since xerces contains its
+ own implementation of the JAXP standard extension, Java
+ will fail to load xerces and report a 'Package Sealing Violation'
+ if both are in the classpath.
+ </li>
+
+
+<li>
+
+<strong>Rename tomcat/lib/parser.jar to tomcat/lib/zparser.jar</strong>
+ Tomcat's parser.jar contains older versions of some the same
+ XML APIS that Xerces uses, and these will prevent Xerces from
+ functioning properly if they appear before Xerces in the classpath.
+ Since Tomcat's startup scripts automatically load all the jar files
+ in tomcat/lib in name order, changing the name of the file causes
it
+ to be loaded last in the classpath.
+ </li>
+
+
+<li>
+
+<strong>Copy the cocoon/lib/core/xerces-XXX.jar and
cocoon/lib/core/xml-apis.jar
+ JAR files to tomcat/lib</strong>
+ Cocoon will now be able to see and use the correct XML libraries.
+ </li>
+
+
+<li>
+
+<strong>Copy cocoon/build/cocoon/cocoon.war into tomcat/webapps</strong>
+
+</li>
+
+
+<li>
+
+<strong>Start Tomcat</strong>
+ Go to the tomcat/bin directory, and run the startup script.
+ </li>
+
+
+<li>
+
+<strong>Start using Cocoon</strong>
+ Access the URI
+ <span class="codefrag">http://localhost:8080/cocoon/</span>
+ with your favorite browser and start to enjoy the world of Cocoon.
+ </li>
+
+</ol>
+</div>
+<a name="N102AB"></a><a
name="Installing+on+Tomcat+4.0+-+4.0.1%2C+4.0.4b1"></a>
+<h4>Installing on Tomcat 4.0 - 4.0.1, 4.0.4b1</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Tomcat 4 is a really straight-forward installation.</p>
+<ol>
+
+<li>
+ Build the Cocoon webapp as described above.
+ </li>
+
+
+<li>
+ Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span>
into
+ <span class="codefrag">tomcat/webapps</span> directory.
+ </li>
+
+
+<li>
+ Start Tomcat: Go to the <span class="codefrag">tomcat/bin</span>
directory,
+ and run the startup script.
+ </li>
+
+
+<li>
+ Open the Cocoon welcome page:
+ <span class="codefrag">http://localhost:8080/cocoon/</span>
+
+</li>
+
+
+<li>
+ Congratulations! You should see the Cocoon welcome page.
+ </li>
+
+</ol>
+</div>
+<a name="N102D2"></a><a name="Installing+on+Tomcat+4.0.3"></a>
+<h4>Installing on Tomcat 4.0.3</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>If you have to use Tomcat 4.0.3, you have to replace its
+ XML parser with the one shipped with Cocoon.</p>
+<ol>
+
+<li>Remove <span class="codefrag">tomcat/common/lib/xerces.jar</span> file.
+ </li>
+
+
+<li>Copy following libraries from the <span
class="codefrag">cocoon/lib/core</span>
+ directory to the tomcat/common/lib directory:
+ <ul>
+
+<li>xalan-XXX.jar</li>
+
+<li>xercesImpl-XXX.jar</li>
+
+<li>xml-apis.jar</li>
+
+</ul>
+
+</li>
+
+
+<li>Copy <span class="codefrag">cocoon/lib/optional/batik-all-XXX.jar</span>
+ to the tomcat/common/lib directory.</li>
+
+
+<li>Edit <span class="codefrag">extra-classpath</span> parameter in the
+ <span class="codefrag">cocoon/src/webapp/WEB-INF/web.xml</span>
file:
+ </li>
+
+</ol>
+<p>For UNIX:</p>
+<pre class="code">
+<init-param>
+ <param-name>extra-classpath</param-name>
+ <param-value>/tomcat/common/lib/xalan-XXX.jar:
+/tomcat/common/lib/xercesImpl-XXX.jar:
+/tomcat/common/lib/xml-apis.jar:
+/tomcat/common/lib/batik-all-XXX.jar</param-value>
+</init-param>
+</pre>
+<p>For Windows:</p>
+<pre class="code">
+<init-param>
+ <param-name>extra-classpath</param-name>
+ <param-value>C:\tomcat\common\lib\xalan-XXX.jar;
+C:\tomcat\common\lib\xercesImpl-XXX.jar;
+C:\tomcat\common\lib\xml-apis.jar;
+C:\tomcat\common\lib\batik-all-XXX.jar</param-value>
+</init-param>
+</pre>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">param-value should be in one line!
+ Also, replace <span class="codefrag">/tomcat/</span> (UNIX), <span
class="codefrag">C:\tomcat\</span>
+ (Windows) with the path to your Tomcat installation home.</div>
+</div>
+<ol>
+
+<li>
+ Clean Cocoon build directory: <span class="codefrag">build
clean</span>
+
+</li>
+
+
+<li>
+ Build Cocoon webapp: <span class="codefrag">build webapp</span>
+
+</li>
+
+
+<li>
+ Remove xalan-XXX.jar, xercesImpl-XXX.jar, batik-all-XXX.jar,
+ and xml-apis.jar from the cocoon.war archive.
+ </li>
+
+
+<li>
+ Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span>
into
+ <span class="codefrag">tomcat/webapps</span> directory.
+ </li>
+
+
+<li>
+ Start Tomcat: Go to the <span class="codefrag">tomcat/bin</span>
directory,
+ and run the startup script.
+ </li>
+
+
+<li>
+ Open the Cocoon welcome page:
+ <span class="codefrag">http://localhost:8080/cocoon/</span>
+
+</li>
+
+
+<li>
+ Congratulations! You should see the Cocoon welcome page.
+ </li>
+
+</ol>
+</div>
+<a name="N10348"></a><a
name="Installing+on+Tomcat+4.0.4b1+LE+with+JDK+1.4.0"></a>
+<h4>Installing on Tomcat 4.0.4b1 LE with JDK 1.4.0</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>This combination is also easy to install.</p>
+<ol>
+
+<li>
+ Build the Cocoon webapp as described above.
+ </li>
+
+
+<li>
+ Copy <span
class="codefrag">cocoon-2.1/build/cocoon/cocoon.war</span> into
+ <span class="codefrag">tomcat/webapps</span> directory.
+ </li>
+
+
+<li>
+ Set environment variable <span
class="codefrag">CATALINA_OPTS=-Djava.awt.headless=true</span>
+
+</li>
+
+
+<li>
+ Start Tomcat: Go to the <span class="codefrag">tomcat/bin</span>
directory,
+ and run the startup script.
+ </li>
+
+
+<li>
+ Open the Cocoon welcome page:
+ <span class="codefrag">http://localhost:8080/cocoon/</span>
+
+</li>
+
+<li>
+ Congratulations! You should see the Cocoon welcome page.
+ </li>
+
+</ol>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+ Make sure that JAVA_HOME enviroment variable points to the JDK1.4.0.
+ If you had JDK1.3.1 or earlier before, <span class="codefrag">build
clean</span> before
+ all these steps.
+ </div>
+</div>
+</div>
+<a name="N1037B"></a><a name="Installing+on+BEA+Weblogic+6.0sp2"></a>
+<h4>Installing on BEA Weblogic 6.0sp2</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>This installs Cocoon using the cocoon.war file.
+ This was successfully installed under Windows 2000 and JDK 1.3.1.
+ Unix users will need to adjust appropriately. If you haven't done
so already,
+ build a domain and a server. In this discussion, the name of the
domain
+ is 'mydomain', the name of the server is 'myserver', and WebLogic
installation
+ directory is <span class="codefrag">c:\bea\wlserver6.0sp2\</span>.
These are the BEA defaults.
+ </p>
+<ol>
+
+<li>
+ Build the Cocoon webapp as described above.
+ </li>
+
+<li>
+ Copy <span class="codefrag">cocoon\build\cocoon\webapp</span>
directory into the
+ <span
class="codefrag">c:\bea\wlserver6.0sp2\config\mydomain\applications\</span>
+ directory of your WebLogic server.
+ </li>
+
+<li>
+ Copy the <span class="codefrag">xerces-XXX.jar</span> and <span
class="codefrag">xml-apis.jar</span> JAR files from the
+ <span class="codefrag">cocoon\lib\core\</span> to the directory of
your choice, say <span class="codefrag">c:\bea\</span>.
+ </li>
+
+<li>
+ Add to the config.xml of the WebLogic server following snippet:
+ </li>
+
+</ol>
+<pre class="code">
+<Application Deployed="true" Name="Cocoon"
+ Path="./config/mydomain/applications">
+ <WebAppComponent Name="cocoon"
+ Targets="myserver"
+ URI="cocoon"/>
+</Application>
+</pre>
+<ol>
+
+<li>
+ Edit <span
class="codefrag">c:\bea\wlserver6.0sp2\config\mydomain\startWebLogic.cmd</span>
file,
+ add xerces and xml-apis JAR files to the classpath:
+ </li>
+
+</ol>
+<pre class="code">
+set CLASSPATH=c:\bea\xerces-XXX.jar;c:\bea\xml-apis.jar
+set CLASSPATH=%CLASSPATH%;.;.\lib\weblogic_sp.jar
+set CLASSPATH=%CLASSPATH%;.\lib\weblogic.jar
+</pre>
+<ol>
+
+<li>
+ Start WebLogic server using <span
class="codefrag">startWebLogic.cmd</span>.
+ </li>
+
+<li>
+ Using a browser, you might want to check WebLogic configuration
using console:
+ <span class="codefrag">http://localhost:7001/console/</span>.
+ </li>
+
+
+<li>
+ Open the Cocoon welcome page:
+ <span class="codefrag">http://localhost:7001/cocoon/</span>
+ (Don't forget the final '/' in the link.)
+ </li>
+
+<li>
+ Congratulations! You should see the Cocoon welcome page.
+ </li>
+
+</ol>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Because of some issues with this version of WebLogic,
you will
+ see lots of exceptions in the WebLogic's console window.
+ </div>
+</div>
+</div>
+<a name="N103D8"></a><a
name="Installing+on+ServletExec+3.1+%28In+Process+with+IIS%29"></a>
+<h4>Installing on ServletExec 3.1 (In Process with IIS)</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>This installs Cocoon in a "war" configuration. This was successfully
+ installed under Windows NT 4.0 and IIS 4. I don't believe that SE
is
+ available for unix.</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Please note that <em>JDK 1.3</em> is required.</div>
+</div>
+<ol>
+
+<li>Install IIS as usual</li>
+
+<li>Install ServletExec (default paths will be used throughout), but
+ don't start it.</li>
+
+<li>Build Cocoon's war file (include lib's)</li>
+
+<li>Copy <em>cocoon.war</em> into
+ <em>C:\Program Files\New Atlanta\ServletExec
ISAPI\webapps\default</em>,
+ creating the directory default if required.</li>
+
+<li>Start IIS.</li>
+
+<li>Open the Cocoon welcome page (<span
class="codefrag">http://localhost/cocoon/</span>)</li>
+
+<li>
+ Congratulations! (hopefully) you should see the Cocoon welcome
page.
+ </li>
+
+</ol>
+</div>
+<a name="N10408"></a><a
name="Installing+on+JBoss+2.4.4+with+Tomcat+4.0.1+%28Catalina%29"></a>
+<h4>Installing on JBoss 2.4.4 with Tomcat 4.0.1 (Catalina)</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ This section describes the deployment of the Cocoon sample WAR with
+ the JBoss-2.4.4_Tomcat-4.0.1 package. It assumes that you built
Cocoon as
+ described above or downloaded the binary Cocoon distribution. All
steps have
+ been tested with a fresh JBoss 2.4.4 installation on Linux and
Windows 2000.
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The JBoss/Tomcat bundle is available from the
+ <a href="http://sourceforge.net/projects/jboss/";>JBoss project
page</a>
+
+</div>
+</div>
+<p>
+ The JBoss/Tomcat package has the following directory structure
+ </p>
+<pre class="code">
+[path]/JBoss-2.4.4_Tomcat-4.0.1/jboss
+[path]/JBoss-2.4.4_Tomcat-4.0.1/catalina
+</pre>
+<p>
+ Subsequently,
+ </p>
+<ul>
+
+<li>
+<span class="codefrag">jboss</span> denotes the <span
class="codefrag">JBoss-2.4.4_Tomcat-4.0.1/jboss</span> directory
+ </li>
+
+<li>
+<span class="codefrag">catalina</span> is short for <span
class="codefrag">JBoss-2.4.4_Tomcat-4.0.1/catalina</span>
+</li>
+
+<li>and <span class="codefrag">cocoon</span> is the base directory of your
Cocoon distribution or CVS checkout.</li>
+
+</ul>
+<p>In order to get Cocoon running you have to install Xerces as default XML
parser for JBoss.</p>
+<ul>
+
+<li>Stop JBoss if it is running.</li>
+
+<li>Remove the following files from the <span
class="codefrag">jboss/lib</span> directory
+ <ul>
+
+<li>crimson.jar</li>
+
+<li>jaxp.jar</li>
+
+</ul>
+
+</li>
+
+<li>Copy <span class="codefrag">xml-apis.jar</span> from <span
class="codefrag">cocoon/lib/core/</span> to <span
class="codefrag">jboss/lib</span>
+</li>
+
+<li>Change <span class="codefrag">jboss/bin/run.sh</span>
+</li>
+
+</ul>
+<pre class="code">
+[...]
+# Add the XML parser jar and set the JAXP factory names
+# Crimson parser JAXP setup(default)
+<strong># Change it to Xerces for C2</strong>
+JBOSS_CLASSPATH=$JBOSS_CLASSPATH:<strong>../lib/xml-apis.jar</strong>
+<strong># Remove the following two lines</strong>
+JAXP=-Djavax.xml.parsers.DocumentBuilderFactory=\
+ org.apache.crimson.jaxp.DocumentBuilderFactoryImpl
+JAXP="$JAXP -Djavax.xml.parsers.SAXParserFactory=\
+ org.apache.crimson.jaxp.SAXParserFactoryImpl"
+[...]
+</pre>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Windows users have to change <span
class="codefrag">run.bat</span> accordingly.
+ </div>
+</div>
+<ul>
+
+<li>Start JBoss with <span class="codefrag">run_with_catalina.sh</span> or
<span class="codefrag">run_with_catalina.bat</span>
+</li>
+
+<li>Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span> to
<span class="codefrag">jboss/deploy</span>
+</li>
+
+<li>Check the server log to make sure that <span class="codefrag">J2EE
application: [...]/cocoon.war is deployed.</span>
+</li>
+
+<li>Open the Cocoon welcome page (<span
class="codefrag">http://localhost:8080/cocoon/</span>)</li>
+
+<li>You should see the Cocoon welcome page.</li>
+
+</ul>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">As both JBoss and Cocoon ship with a Hypersonic
database installed,
+ these two conflict and you won't be able to use Cocoon database
(SQL) samples.
+ Then again, you probably use JBoss for EJB persistence anyway, so
this shouldn't
+ bother you too much ;-)
+ </div>
+</div>
+</div>
+<a name="N1049B"></a><a
name="Installing+on+JBoss+2.2.2+with+Tomcat+3.2.2"></a>
+<h4>Installing on JBoss 2.2.2 with Tomcat 3.2.2</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>This section describes the deployment of the Cocoon sample WAR with
+ the JBoss 2.2.2/Tomcat-3.2.2 package. It assumes that you built
Cocoon as described above.
+ All steps have been tested with a fresh JBoss 2.2.2 installation on
Linux and Windows ME(sic).</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The JBoss/Tomcat bundle is available from the
+ <a href="http://sourceforge.net/projects/jboss/";>JBoss project
page</a>
+
+</div>
+</div>
+<p>The JBoss/Tomcat package has the following directory structure</p>
+<pre class="code">
+[path]/JBoss-2.2.2_Tomcat-3.2.2/jboss
+[path]/JBoss-2.2.2_Tomcat-3.2.2/tomcat
+ </pre>
+<p>Subsequently,</p>
+<ul>
+
+<li>
+<span class="codefrag">jboss</span> denotes the <span
class="codefrag">JBoss-2.2.2_Tomcat-3.2.2/jboss</span> directory</li>
+
+<li>
+<span class="codefrag">Tomcat</span> is short for <span
class="codefrag">JBoss-2.2.2_Tomcat-3.2.2/tomcat</span>
+</li>
+<li>and <span class="codefrag">cocoon</span> is the base directory of your
Cocoon distribution or CVS checkout.</li>
+
+</ul>
+<p>In order to get Cocoon running you have to install Xerces as default XML
parser for JBoss.</p>
+<ul>
+
+<li>Stop the server if it is running.</li>
+
+<li>Remove the following files from the <span
class="codefrag">jboss/lib</span> directory
+ <ul>
+
+<li>crimson.jar</li>
+
+<li>jaxp.jar</li>
+
+<li>xml.jar</li>
+
+</ul>
+
+</li>
+
+<li>Remove the following files from the <span
class="codefrag">tomcat/lib</span>
+ directory
+ <ul>
+
+<li>jaxp.jar</li>
+
+<li>parser.jar</li>
+
+</ul>
+
+</li>
+
+<li>Copy <span class="codefrag">xerces-XXX.jar</span> from <span
class="codefrag">cocoon/lib/core/</span> to <span
class="codefrag">jboss/lib</span>
+</li>
+
+<li>Change <span class="codefrag">jboss/bin/run.sh</span>
+</li>
+
+</ul>
+<pre class="code">
+[...]
+# Add the XML parser jars and set the JAXP factory names
+# Crimson parser JAXP setup(default)
+<strong># Change it to Xerces for C2</strong>
+JBOSS_CLASSPATH=$JBOSS_CLASSPATH:<strong>../lib/xerces-XXX.jar</strong>
+<strong># Remove the following two lines</strong>
+JAXP=-Djavax.xml.parsers.DocumentBuilderFactory=\
+ org.apache.crimson.jaxp.DocumentBuilderFactoryImpl
+JAXP="$JAXP -Djavax.xml.parsers.SAXParserFactory=\
+ org.apache.crimson.jaxp.SAXParserFactoryImpl"
+[...]
+ </pre>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Windows users have to change <span
class="codefrag">run.bat</span> accordingly.
+ </div>
+</div>
+<ul>
+
+<li>Start JBoss with <span class="codefrag">run_with_tomcat.sh</span> or
<span class="codefrag">run_with_tomcat.bat</span>
+</li>
+
+<li>Copy <span class="codefrag">cocoon/build/cocoon/cocoon.war</span> to
<span class="codefrag">jboss/deploy</span>
+</li>
+
+<li>Check the server log to make sure that <span class="codefrag">J2EE
application: [...]/cocoon.war is deployed.</span>
+</li>
+
+<li>Open the Cocoon welcome page (<span
class="codefrag">http://localhost:8080/cocoon/</span>)</li>
+
+<li>
+ Congratulations! (hopefully) you should see the Cocoon welcome
page.
+ </li>
+
+</ul>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">As both JBoss and Cocoon ship with a Hypersonic
database installed, these two conflict and you won't be able to use Cocoon
database (SQL) samples. Then again, you probably use JBoss for EJB persistence
anyway, so this shouldn't bother you too much ;-)
+ </div>
+</div>
+</div>
+<a name="N1053F"></a><a name="Installing+on+Resin+2.x"></a>
+<h4>Installing on Resin 2.x</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ This section describes the deployment of the Cocoon sample WAR with
Resin 2.x.
+ It assumes that you built Cocoon as described above. All steps have
been tested
+ with a fresh Resin 2.0.0, 2.0.4, and 2.1.3 installations (the
package is available from
+ <a href="http://www.caucho.com/download/";>Resin's download page</a>)
+ </p>
+<p>After unpacking the Resin package you get the following directory
structure</p>
+<pre class="code">
+[path]...
+[path]/resin-2.x/conf
+[path]/resin-2.x/lib
+[path]/resin-2.x/webapps
+[path]...</pre>
+<p>To get Cocoon running do the following:</p>
+<ul>
+
+<li>Stop the server if it is running.</li>
+
+
+<li>
+
+<strong>For 2.0.3 version and older:</strong>
+ If yours Resin is older then 2.0.4, you have to install Xerces as
default XML parser for Resin
+ <ul>
+<li>Remove the following files from the <span
class="codefrag">resin-2.0.x/lib</span> directory:
+ <ul>
+
+<li>jaxp.jar</li>
+
+<li>dom.jar</li>
+
+<li>sax.jar</li>
+
+</ul>
+
+</li>
+
+<li>Copy <span class="codefrag">xerces-XXX.jar</span> and <span
class="codefrag">xml-apis.jar</span>
+ JAR file from <span
class="codefrag">cocoon-2.1/lib/core/</span> to
+ the <span class="codefrag">resin-2.0.x/lib/</span>
directory.</li>
+
+</ul>
+
+</li>
+
+
+<li>
+
+<strong>For 2.0.4 version and newer:</strong>
+ Edit <span class="codefrag">resin-2.x/conf/resin.conf</span>,
change value of the
+ <span class="codefrag">servlet-classloader-hack</span> element to
<span class="codefrag">true</span>
+
+</li>
+
+
+<li>Copy the <span
class="codefrag">cocoon-2.1/build/cocoon/cocoon.war</span> WAR file to <span
class="codefrag">resin-2.x/webapps</span> directory
+ </li>
+
+<li>Start Resin as usual</li>
+
+<li>Open the Cocoon welcome page (<span
class="codefrag">http://localhost:8080/cocoon/</span>)</li>
+
+<li>Congratulations! (hopefully) you should see the Cocoon welcome page.</li>
+
+</ul>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content"> If you want to place Cocoon webapp in a
+ directory different than <span
class="codefrag">resin-2.x/webapps</span>, you need
+ to edit <span class="codefrag">resin-2.x/conf/resin.conf</span> file
and add a line
+ somewhere in <span class="codefrag"><host></span> tag:
+ <span class="codefrag"><web-app id='/cocoon'
app-dir='/path/to/webapp/cocoon.war'/></span>
+
+</div>
+</div>
+</div>
+<a name="N105B9"></a><a name="Installing+on+HP-AS+8.X"></a>
+<h4>Installing on HP-AS 8.X</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>HP-AS is J2EE application server available from the Hewlett-Packard
website.
+ <a href="http://www.hpmiddleware.com/download";>Download and install
HP-AS 8.X</a>
+
+</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Cocoon cannot be deployed as a .war file in HP-AS.
+ Use the following steps to deploy cocoon.war:
+ </div>
+</div>
+<ol>
+
+<li>Extract the <span class="codefrag">cocoon.war</span> file to some
directory, using <span class="codefrag">WinZIP</span>
+ or a similar utility to extract the files.</li>
+
+<li>To run HP-AS, go to<strong><span class="codefrag">( Start | Programs |
HP Middleware | HP Application Server | System Console).</span></strong>
+
+<br>
+ The HP-AS Console appears with a Log browser.
+ As the HP-AS kernel starts and initializes, messages will appear
in the
+ status bar of the console.
+ Wait for the message 'Kernel started' to appear in the Log
browser.
+ The following message should display:<br>
+<br>
+
+<span class="codefrag">[10/16/01 16:03:50][localhost_][S]:Kernel "kernel"
started.</span>
+<br>
+<br>
+
+</li>
+
+<li>To verify that an instance of HP-AS is running,
+ open a web browser and go to <span
class="codefrag">http://localhost:9090/helloservlet/hello</span>
+
+<br>
+ An HTML page should appear containing the following message:
+ <br>
+<br>
+
+<span class="codefrag">Congratulations!</span>
+<br>
+
+<span class="codefrag">Congratulations from the HelloWorldServlet</span>
+<br>
+
+<span class="codefrag">It appears you have the server running</span>
+<br>
+
+<span class="codefrag">My servlet path is /hello</span>
+<br>
+<br>
+
+<strong><span class="codefrag">This test is valid only if you've performed a
full install of HP-AS</span></strong>
+
+<br>
+<br>
+
+</li>
+
+<li>In the HP-AS console, select <strong>View | Deployment Window</strong>.
+ In the <strong>Available Files</strong> pane on the right,
+ browse to the the directory you extracted the <span
class="codefrag">cocoon.war</span> file to.
+ <br>
+ Expand this directory, and then drag and drop the
+ <span class="codefrag">cocoon</span> sub-directory node to the
<strong>kernel.j2ee-partition</strong> icon
+ in the left pane.
+ </li>
+
+<li>When prompted, answer <strong>Yes</strong> to the deployment
question.<br>
+ This should create an appropriate entry in the HP-AS j2ee
partition configuration file.<br>
+
+<strong><span class="codefrag">In the current version of the console,
+ there is no indication that the operation succeeded.
+ If you see a parser error in the Log browser, ignore
it.</span></strong>
+
+</li>
+
+<li>To test the deployment, open a web browser and go to the following
URL:<br>
+<br>
+
+<span class="codefrag">http://localhost:9090/cocoon/welcome</span>
+
+<br>
+<br>
+ Congratulations! (hopefully) you should see the Cocoon welcome
page.
+ (this request may take some time).
+ <br>
+
+</li>
+
+</ol>
+</div>
+<a name="N10639"></a><a name="Installing+on+JRun+3.1"></a>
+<h4>Installing on JRun 3.1</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ This section describes the deployment of the Cocoon sample WAR
with JRun 3.1,
+ on its default server. It assumes that you built Cocoon as
described above. All
+ steps have been tested under Win2000.
+ </p>
+<p>To get Cocoon running do the following:</p>
+<ul>
+
+<li>Stop the default and admin servers if they are running.</li>
+
+<li>Remove <span class="codefrag">jaxp.jar</span> and <span
class="codefrag">parser.jar</span>
+ files (Crimson XML parser) from the <span
class="codefrag">jrun/lib/ext/</span> directory.
+ </li>
+
+<li>Install Xerces as default XML parser for JRun by copying
+ <span class="codefrag">xerces-XXX.jar</span> and <span
class="codefrag">xml-apis.jar</span> JAR
+ files from the <span
class="codefrag">cocoon-2.1/lib/core/</span> to <span
class="codefrag">jrun/lib/ext/</span>
+ directory.
+ </li>
+
+<li>Update Rhino shipped with JRun with newer version from the Cocoon by
+ overwriting <span class="codefrag">jrun/lib/rhino.jar</span> JAR
file
+ with the <span
class="codefrag">cocoon-2.1/lib/optional/rhino-1.5r3.jar</span> file.
+ </li>
+
+<li>Start JRun admin server.</li>
+
+<li>Start JRun default server.</li>
+
+<li>Open JRun admin page:
+ <span class="codefrag">http://localhost:8000/</span>
+
+</li>
+
+<li>Deploy cocoon.war webapp using console. Use same values for
+ application name and URI prefix (e.g., application name "cocoon",
+ URI "/cocoon").</li>
+
+<li>Open the Cocoon welcome page:
+ <span class="codefrag">http://localhost:8100/cocoon/</span>
+
+</li>
+
+<li>Congratulations! (hopefully) you should see the Cocoon welcome page.</li>
+
+</ul>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Instead of deploying WAR file using console, same could
be done by copying
+ <span class="codefrag">cocoon-2.1/build/cocoon/webapp</span> under
<span class="codefrag">jrun/servers/default/</span>
+ directory and adding following lines to the <span
class="codefrag">jrun/servers/default/local.properties</span>:
+ </div>
+</div>
+<pre class="code">
+cocoon.rootdir=/absolute/path/to/jrun/servers/default/cocoon
+cocoon.class={webapp.service-class}
+webapp.mapping./cocoon=cocoon</pre>
+</div>
+<a name="N10698"></a><a
name="Installing+on+iPlanet+Web+Server+4.x+and+other+engines+without+context+management"></a>
+<h4>Installing on iPlanet Web Server 4.x and other engines without context
management</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ iPlanet Web Server 4.x provides the servlet 2.2 API (<span
class="codefrag">javax.servlet.*</span> classes),
+ but the servlet engine doesn't handle servlet contexts. This means
there is no classloader
+ built with the contents of <span
class="codefrag">WEB-INF/classes</span> and <span
class="codefrag">WEB-INF/lib</span> and that
+ resolution of context resources (using <span
class="codefrag">ServletContext.getResource()</span>) doesn't give
+ the expected results.
+ </p>
+<p>
+ To be able to run on such non-compliant engines, Cocoon provides a
bootstrap servlet in
+ <span
class="codefrag">org.apache.cocoon.BootstrapServlet</span>that handles all the
servlet context related
+ behaviours needed for proper functioning.
+ </p>
+<p>
+ To use this bootstrap servlet, configure your servlet engine as
follows (how to do it depends
+ on the actual engine - see below for iPlanet) :
+ </p>
+<ul>
+
+<li>add cocoon.jar (and only this one) in the engine's classpath,</li>
+
+<li>declare the <span
class="codefrag">org.apache.cocoon.servlet.BootstrapServlet</span> servlet,</li>
+
+<li>add a "<span class="codefrag">context-directory</span>" parameter, whose
value is the absolute path to Cocoon's
+ context (e.g. "<span
class="codefrag">/path/webapp/cocoon</span>"),</li>
+
+<li>add any other cocoon parameters you want to this servlet (see <span
class="codefrag">web.xml</span> for a
+ description of available parameters),</li>
+
+<li>configure a path translation from "/" to the servlet.</li>
+
+</ul>
+<p>For iPlanet Web Server 4.x, this translates to :</p>
+<ul>
+
+<li>connect to the administration server of your web server,</li>
+
+<li>in the "Servlet" tabs, select "Configure servlet attributes", and enter
the following :
+ <ul>
+
+<li>Servlet Name : <span class="codefrag">cocoon</span>
+</li>
+
+<li>Servlet Code (class name) : <span
class="codefrag">org.apache.cocoon.servlet.BootstrapServlet</span>
+</li>
+
+<li>Servlet Classpath : <span
class="codefrag">/path/webapp/cocoon/WEB-INF/lib/cocoon.jar</span>
+</li>
+
+<li>Servlet Args : <span
class="codefrag">context-directory=/path/webapp/cocoon</span> (and any other
Cocoon
+ parameters you want)</li>
+
+</ul>
+
+</li>
+
+<li>select "Configure Servlet Virtual Path Translation" and enter the
following :
+ <ul>
+
+<li>Virtual Path : <span class="codefrag">@/.*</span>
+</li>
+
+<li>Servlet Name : <span class="codefrag">cocoon</span>
+</li>
+
+</ul>
+
+</li>
+
+<li>save and apply your changes, and enjoy the latest Cocoon on an
old-fashioned servlet engine !</li>
+
+</ul>
+</div>
+<a name="N1070B"></a><a name="Installing+on+WebSphere+4.0"></a>
+<h4>Installing on WebSphere 4.0</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ This section describes the deployment of the Cocoon sample WAR
with WebSphere 4.0,
+ on its default server. It assumes that you built Cocoon as
described above. All
+ steps have been tested under Win2000 and WebSphere AEs 4.0.1
a0136.02.
+ </p>
+<p>To get Cocoon running do the following:</p>
+<ul>
+
+<li>Start the server using <span class="codefrag">startServer</span> startup
script.</li>
+
+<li>Open admin page:
+ <span class="codefrag">http://localhost:9090/admin/</span>
+
+</li>
+
+<li>Deploy cocoon.war webapp using console.</li>
+
+<li>Save server configuration file.</li>
+
+<li>Restart the server using <span class="codefrag">stopServer</span> and
+ <span class="codefrag">startServer</span> scripts.</li>
+
+<li>Open the Cocoon welcome page:
+ <span class="codefrag">http://localhost:9080/cocoon/</span>
+
+</li>
+
+<li>Congratulations! (hopefully) you should see the Cocoon welcome page.</li>
+
+</ul>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">WebSphere power users might deploy Cocoon by exploding
cocoon.war into
+ <span class="codefrag">installedApps</span> directory and editing
+ <span class="codefrag">config/server-cfg.xml</span> file.
+ </div>
+</div>
+</div>
+</div>
+
+</div>
+</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end Content==================-->
+</table>
+</td>
+</tr>
+</table>
+<!--================= end Menu, NavBar, Content ==================-->
+<!--================= start Footer ==================-->
+<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
+<tr>
+<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="../skin/images/spacer.gif" class="spacer"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
+</tr>
+<tr>
+<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
+ 1999-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
+ document.write(" - "+"Last Published: " +
document.lastModified);
+ // --></script></font></td>
+</tr>
+<tr>
+<td colspan="2" align="left" bgcolor="#CFDCED" class="logos">
+<div>
+<a href="http://validator.w3.org/check/referer";><img width="88" height="31"
alt="Valid HTML 4.01!" src="../skin/images/valid-html401.png"
class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/";><img
width="88" height="31" alt="Valid CSS!" src="../skin/images/vcss.png"
class="logoImage"></a><img alt="" height="1" width="10"
src="../skin/images/spacer.gif"><a href="http://xml.apache.org/forrest/";><img
border="0" alt="Built with Apache Forrest logo"
src="../images/built-with-forrest-button.png" width="88" height="31"><img
height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"></a>
+</div>
+</td>
+</tr>
+</table>
+<!--================= end Footer ==================-->
+</body>
+</html>
1.2 +612 -1213 cocoon-site/site/2.1/installing/index.pdf
<<Binary file>>
1.5 +1248 -246 cocoon-site/site/2.1/installing/jars.html
Index: jars.html
===================================================================
RCS file: /home/cvs/cocoon-site/site/2.1/installing/jars.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- jars.html 21 May 2003 15:23:24 -0000 1.4
+++ jars.html 9 Jul 2003 16:58:55 -0000 1.5
@@ -1,246 +1,1248 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Cocoon JARs</title>
-<link type="text/css" href="../skin/page.css" rel="stylesheet">
-</head>
-<body text="#000000" bgcolor="#FFFFFF">
-<!--================= start Navigation Path ==================-->
-<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<tr>
-<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" border="0"
src="../skin/images/spacer.gif"><!--===== breadcrumb trail
(javascript-generated) ====--><font size="2" face="Arial, Helvetica,
Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0"
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Navigation Path ==================-->
-<!--================= start Banner ==================-->
-<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<tr>
-<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://xml.apache.org";><img border="0"
class="logoImage" alt="Apache Cocoon" src="../images/group-logo.gif"></a></td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache
Cocoon" src="../images/project-logo.gif"></a></td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
-<form target="_blank" action="http://www.google.com/search"; method="get">
-<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
-<tr>
-<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td><td nowrap="nowrap"><input
value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15"
name="q" id="query" type="text"><img height="1" width="5" alt=""
src="../skin/images/spacer.gif"><input name="Search" value="Search"
type="submit">
-<br>
-<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
- the Apache Cocoon site
-
-
- </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10"
width="9" src="../skin/images/search-right.gif"></td>
-</tr>
-</table>
-</form>
-</td>
-<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" bgcolor="#294563" colspan="2">
-<!--================= start Tabs ==================-->
-<div class="tab">
-<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td width="8"><img alt="" height="8" width="8"
src="../skin/images/spacer.gif"></td><td valign="bottom">
-<table summary="selected tab" style="height: 1.7em" border="0"
cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a href="../index.html"><font
color="#000000">Home</font></a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-</div>
-<!--================= end Tabs ==================-->
-</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Banner ==================-->
-<!--================= start Menu, NavBar, Content ==================-->
-<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top">
-<table summary="menu" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<!--================= start left top NavBar ==================-->
-<td rowspan="3" valign="top">
-<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
-</tr>
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td>
-<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img
width="10" height="10" alt="" src="../skin/images/spacer.gif"></td><td
nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
-<!--================= start Menu items ==================-->
-<div class="menu">
-<ul>
-<li>
-<font color="#CFDCED">Navigation</font>
-<ul>
-
-<li>
-<a href="../index.html">Main</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Installation</font>
-<ul>
-
-<li>
-<a target="_blank" href="http://cocoon.apache.org/mirror.cgi";>Download</a>
-</li>
-
-<li>
-<a href="index.html">Installing</a>
-</li>
-
-<li>
-<a href="updating.html">Updating</a>
-</li>
-
-<li>
-<span class="sel"><font color="#ffcc00">Jars</font></span>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Testing</font>
-<ul>
-
-<li>
-<a href="tests.html">Overview</a>
-</li>
-
-</ul>
-</li>
-</ul>
-</div>
-<!--================= end Menu items ==================-->
-</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="../skin/images/spacer.gif"></td><td bgcolor="#294563"><img
width="1" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" border="0" alt="" src="../skin/images/spacer.gif"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
-</tr>
-<tr>
-<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td><td valign="top" width="100%">
-<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<!--================= start middle NavBar ==================-->
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif"></td><td align="left" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
-
- </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif"></td><td align="right" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
-
- </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img
width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end middle NavBar ==================-->
-<!--================= start Content==================-->
-<tr>
-<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td><td align="left" width="100%">
-<div class="content">
-<table class="title" summary="">
-<tr>
-<td valign="middle">
-<h1>Cocoon JARs</h1>
-</td><script Language="Javascript">
-
-function printit(){
-if (window.print) {
- window.print() ;
-} else {
- var WebBrowser = '<OBJECT
CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0"
ID="WebBrowser1"></OBJECT>';
-document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
- WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box
WebBrowser1.outerHTML = "";
-}
-}
-</script><script Language="Javascript">
-var NS = (navigator.appName == "Netscape");
-var VERSION = parseInt(navigator.appVersion);
-if (VERSION > 3) {
- document.write('<td nowrap="nowrap" width="40" align="center">');
- document.write(' <a class="dida" href="javascript:printit()">');
- document.write(' <img alt="Print this Page"
src="../skin/images/printer.gif" border="0"><br>');
- document.write(' print</a>');
- document.write('</td>');
-}
-</script><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="jars.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" border="0"><br>
- PDF</a></td>
-</tr>
-</table>
-<p>
-<font size="-2">by John Morrison</font>
-</p>
-<ul class="minitoc">
-<li>
-<a href="#Replace">Replace</a>
-</li>
-</ul>
-
-<a name="N10013"></a><a name="Replace"></a>
-<h3>Replace</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>This is now an autogenerated file. If you see this message, somethings
- wrong with the build!.</p>
-</div>
-
-</div>
-</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end Content==================-->
-</table>
-</td>
-</tr>
-</table>
-<!--================= end Menu, NavBar, Content ==================-->
-<!--================= start Footer ==================-->
-<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
-<tr>
-<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="../skin/images/spacer.gif"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
-</tr>
-<tr>
-<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
- 1999-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
- document.write(" - "+"Last Published: " +
document.lastModified);
- // --></script></font></td>
-</tr>
-<tr>
-<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
-</tr>
-</table>
-<!--================= end Footer ==================-->
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Cocoon JARs</title>
+<link type="text/css" href="../skin/page.css" rel="stylesheet">
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<!--================= start Navigation Path ==================-->
+<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font
size="2" face="Arial, Helvetica, Sans-serif"><script
src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Navigation Path ==================-->
+<!--================= start Banner ==================-->
+<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<!--================= start Group Logo ==================-->
+<td bgcolor="#294563"><a href=""></a></td>
+<!--================= end Group Logo ==================-->
+<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache
Cocoon" src="../images/project-logo.gif"></a></td>
+<!--================= end Project Logo ==================-->
+<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
+<form target="_blank" action="http://www.google.com/search"; method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
+<tr>
+<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"
class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org"
name="sitesearch" type="hidden"><input size="15" name="q" id="query"
type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><input name="Search" value="Search" type="submit">
+<br>
+<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
+ the Apache Cocoon site
+
+
+ </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0"
height="10" width="9" src="../skin/images/search-right.gif"></td>
+</tr>
+</table>
+</form>
+</td>
+<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" bgcolor="#294563" colspan="2">
+<!--================= start Tabs ==================-->
+<div class="tab">
+<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td width="6"><img alt="" height="8" width="6"
src="../skin/images/spacer.gif"></td><td valign="bottom">
+<table summary="selected tab" style="height: 1.8em" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a href="../index.html"><font
color="#000000">Home</font></a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</div>
+<!--================= end Tabs ==================-->
+</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Banner ==================-->
+<!--================= start Menu, NavBar, Content ==================-->
+<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top">
+<table summary="menu" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<!--================= start left top NavBar ==================-->
+<td rowspan="3" valign="top">
+<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
+</tr>
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td>
+<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom"
bgcolor="#4C6C8F"><img width="10" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"
valign="top" bgcolor="#4C6C8F">
+<!--================= start Menu items ==================-->
+<div class="menu">
+<ul>
+<li>
+<font color="#CFDCED">Navigation</font>
+<ul>
+
+<li>
+<a href="../index.html">Main</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Installation</font>
+<ul>
+
+<li>
+<a target="_blank" href="http://cocoon.apache.org/mirror.cgi";>Download</a>
+</li>
+
+<li>
+<a href="index.html">Installing</a>
+</li>
+
+<li>
+<a href="updating.html">Updating</a>
+</li>
+
+<li>
+<span class="sel"><font color="#ffcc00">Jars</font></span>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Testing</font>
+<ul>
+
+<li>
+<a href="tests.html">Overview</a>
+</li>
+
+</ul>
+</li>
+</ul>
+</div>
+<!--================= end Menu items ==================-->
+</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
+</tr>
+<tr>
+<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td><td valign="top" width="100%">
+<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<!--================= start middle NavBar ==================-->
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="right"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td width="10"
bgcolor="#CFDCED"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end middle NavBar ==================-->
+<!--================= start Content==================-->
+<tr>
+<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="100%">
+<div class="content">
+<table class="title" summary="">
+<tr>
+<td valign="middle">
+<h1>Cocoon JARs</h1>
+</td><script Language="Javascript">
+
+function printit(){
+if (window.print) {
+ window.print() ;
+} else {
+ var WebBrowser = '<OBJECT
CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0"
ID="WebBrowser1"></OBJECT>';
+document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
+ WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box
WebBrowser1.outerHTML = "";
+}
+}
+</script><script Language="Javascript">
+var NS = (navigator.appName == "Netscape");
+var VERSION = parseInt(navigator.appVersion);
+if (VERSION > 3) {
+ document.write('<td nowrap="nowrap" width="40" align="center">');
+ document.write(' <a class="dida" href="javascript:printit()">');
+ document.write(' <img alt="Print this Page"
src="../skin/images/printer.gif" class="skin"><br>');
+ document.write(' print</a>');
+ document.write('</td>');
+}
+</script><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="jars.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a></td>
+</tr>
+</table>
+<p>
+<font size="-2">by John Morrison</font>
+</p>
+<ul class="minitoc">
+<li>
+<a href="#What%2C+why+and+when...">What, why and when...</a>
+</li>
+</ul>
+
+<a name="N10013"></a><a name="What%2C+why+and+when..."></a>
+<h3>What, why and when...</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>This is a list of the available jars, what they are, where they come from,
+ and what they do.</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tr>
+
+<th colspan="1" rowspan="1">Title</th>
+<th colspan="1" rowspan="1">Jar (type/name)</th>
+<th colspan="1" rowspan="1">Description</th>
+<th colspan="1" rowspan="1">Used by</th>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a
href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html";>Doug
Lea's Concurrent Utilities</a>
+</td>
+<td colspan="1" rowspan="1">core/util.concurrent-1.3.1.jar</td>
+<td colspan="1" rowspan="1">
+ The concurrency management primitives that will be the
+ foundation of JDK 1.5 concurrency management.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur DataSource</a>
+</td>
+<td colspan="1" rowspan="1">databases/lib/excalibur-datasource-1.1.1.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/commons/cli/";>Jakarta Commons CLI</a>
+</td>
+<td colspan="1" rowspan="1">core/commons-cli-1.0.jar</td>
+<td colspan="1" rowspan="1">
+ Part of jakarta-commons, it's a package that
+ is used to manage commandline options.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur
Collections</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-collections-20020820.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Component</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-component-1.1.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Concurrent</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-concurrent-20020820.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Event</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-event-1.0.3.jar</td>
+<td colspan="1" rowspan="1">
+ This is the Excalibur Event package which includes event queues,
+ asynchronous command processing, and the interfaces to support
+ event based programming.
+ </td>
+<td colspan="1" rowspan="1">Cocoon Flow</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur I18n</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-i18n-1.0.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Instrument</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-instrument-1.0.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Instrument
Manager</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-instrument-manager-1.0.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Instrument
Manager Interfaces</a>
+</td>
+<td colspan="1"
rowspan="1">core/excalibur-instrument-manager-interfaces-1.0.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur IO</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-io-1.1.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Logger</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-logger-1.0.1.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Monitor</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-monitor-1.0.2.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Naming</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-naming-1.0.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Pool</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-pool-1.2.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur
SourceResolve</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-sourceresolve-20030630.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur Store</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-store-20030317.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/excalibur/";>Avalon Excalibur XMLUtil</a>
+</td>
+<td colspan="1" rowspan="1">core/excalibur-xmlutil-20030520.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/framework/";>Avalon Framework</a>
+</td>
+<td colspan="1" rowspan="1">core/avalon-framework-4.1.4.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon, it is a set of classes and patterns that
+ support high level server development.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://incubator.apache.org/projects/altrmi/";>Avalon AltRMI
Common</a>
+</td>
+<td colspan="1" rowspan="1">optional/altrmi-common-0.9.2.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon for communicating with a remote
+ server.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://incubator.apache.org/projects/altrmi/";>Avalon AltRMI Server
implementation</a>
+</td>
+<td colspan="1" rowspan="1">optional/altrmi-server-impl-0.9.2.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon for communicating with a remote
+ server.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://incubator.apache.org/projects/altrmi/";>Avalon AltRMI Server
interfaces</a>
+</td>
+<td colspan="1" rowspan="1">optional/altrmi-server-interfaces-0.9.2.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon for communicating with a remote
+ server.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://incubator.apache.org/projects/altrmi/";>Avalon AltRMI
Registry</a>
+</td>
+<td colspan="1" rowspan="1">optional/altrmi-registry-0.9.2.jar</td>
+<td colspan="1" rowspan="1">
+ Part of avalon for communicating with a remote
+ server.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/commons/collections.html";>Jakarta Commons
Collections</a>
+</td>
+<td colspan="1" rowspan="1">core/commons-collections-2.1.jar</td>
+<td colspan="1" rowspan="1">Common implementations of collection
classes.</td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/regexp/";>Jakarta Regexp</a>
+</td>
+<td colspan="1" rowspan="1">core/jakarta-regexp-1.2.jar</td>
+<td colspan="1" rowspan="1">
+ Regexp is a Java Regular Expression package that was graciously
+ donated to the Apache Software Foundation by Jonathan Locke.
+ </td>
+<td colspan="1" rowspan="1">sitemap matchers</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://avalon.apache.org/logkit/";>Avalon Logkit</a>
+</td>
+<td colspan="1" rowspan="1">core/logkit-1.2.jar</td>
+<td colspan="1" rowspan="1">
+ avalon-logkit is a logging toolkit designed for secure
+ performance orientated logging in applications.
+ </td>
+<td colspan="1" rowspan="1">Cocoon logging</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/log4j/docs/index.html";>LogFactor5</a>
+</td>
+<td colspan="1" rowspan="1">optional/logfactor5-1.2.8.jar</td>
+<td colspan="1" rowspan="1">
+ LogFactor5 is a graphical logkit browser, distributed
+ as a part of Log4J.
+ </td>
+<td colspan="1" rowspan="1">Cocoon logging</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://xml.apache.org/xalan/";>The XSLT processor</a>
+</td>
+<td colspan="1" rowspan="1">endorsed/xalan-2.5.1.jar</td>
+<td colspan="1" rowspan="1">
+ Xalan is an XSLT processor that fully supports the W3C specs.
+ Includes XSLTC.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://xml.apache.org/xerces-j/";>The XML parser</a>
+</td>
+<td colspan="1" rowspan="1">endorsed/xercesImpl-2.4.0.jar</td>
+<td colspan="1" rowspan="1">Xerces is an XML parser.</td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://xml.apache.org/commons/";>The XML APIs</a>
+</td>
+<td colspan="1" rowspan="1">endorsed/xml-apis.jar</td>
+<td colspan="1" rowspan="1">
+ JAXP, DOM and SAX interfaces.
+ These are the common interfaces for XML processing.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://xml.apache.org/batik/";>Batik</a>
+</td>
+<td colspan="1" rowspan="1">batik/lib/batik-all-1.5b5.jar</td>
+<td colspan="1" rowspan="1">
+ Batik is a Java based toolkit for applications which handle images in
+ the Scalable Vector Graphics (SVG) format for various purposes, such as
+ viewing, generation or manipulation.</td>
+<td colspan="1" rowspan="1">SVG serializer (batik block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://oss.software.ibm.com/developerworks/projects/bsf";>BSF
scripting framework</a>
+</td>
+<td colspan="1" rowspan="1">bsf/lib/bsf-2.2.jar</td>
+<td colspan="1" rowspan="1">
+ The Bean Scripting Framework (BSF) is an architecture for
+ incorporating scripting into, and enabling scripting against, Java
+ applications and applets. Using BSF, an application can use scripting,
+ and become scriptable, against any BSF-supported language. When BSF
+ supports additional languages, the application will automatically
+ support the additional languages.
+ </td>
+<td colspan="1" rowspan="1">Script generator, script action (bsf block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://delicon.sourceforge.net";>Device capabilities</a>
+</td>
+<td colspan="1" rowspan="1">deli/lib/deli-0.9.1.jar</td>
+<td colspan="1" rowspan="1">
+ Open Source Delivery Context Java Library supporting CC/PP and UAProf.
+ Different web-enabled devices have different input, output, hardware,
+ software, network and browser capabilities. In order for a web server or
+ web-based application to provide optimized content to different clients
+ it requires a description of the capabilities of the client known as the
+ delivery context.
+ </td>
+<td colspan="1" rowspan="1">DELI (deli block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/commons/httpclient/";>Jakart Commons
HttpClient</a>
+</td>
+<td colspan="1" rowspan="1">core/commons-httpclient-2.0-beta2.jar</td>
+<td colspan="1" rowspan="1">
+ Although the java.net package provides basic support for accessing
+ resources via HTTP, it doesn't provide the full flexibility or
+ functionality needed by many applications. The Jakarta Commons HttpClient
+ component seeks to fill this void by providing an efficient, up-to-date,
+ and feature-rich package implementing the client side of the most recent
+ HTTP standards and recommendations.
+ </td>
+<td colspan="1" rowspan="1">SOAP logicsheet, WebServiceProxyGenerator,
HttpProxyGenerator</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.lowagie.com/iText/";>iText XML to PDF/HTML/RTF converter
(Renderer)</a>
+</td>
+<td colspan="1" rowspan="1">itext/lib/itext-0.99.jar</td>
+<td colspan="1" rowspan="1">iText reads XML documents and turns them into
PDFs</td>
+<td colspan="1" rowspan="1">iText serializer</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.lowagie.com/iText/";>iText XML to PDF/HTML/RTF converter
(XML APIs)</a>
+</td>
+<td colspan="1" rowspan="1">itext/lib/itext-xml-0.99.jar</td>
+<td colspan="1" rowspan="1">iText reads XML documents and turns them into
PDFs</td>
+<td colspan="1" rowspan="1">iText serializer</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://xml.apache.org/fop/";>XML FO processor</a>
+</td>
+<td colspan="1" rowspan="1">fop/lib/fop-0.20.5rc3a.jar</td>
+<td colspan="1" rowspan="1">
+ FOP is a Java application that reads a formatting object tree conforming
to
+ the XSL recommendation and then turns it into a PDF document.
+ </td>
+<td colspan="1" rowspan="1">FOP serializer (fop block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.jfor.org";>XSL-FO to RTF converter</a>
+</td>
+<td colspan="1" rowspan="1">jfor/lib/jfor-0.7.1.jar</td>
+<td colspan="1" rowspan="1">jfor is a Java application that reads XSL-FO
documents
+ and converts them to RTF format, allowing them to be loaded in
+ common wordprocessors.
+ </td>
+<td colspan="1" rowspan="1">RTF serializer (jfor block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://hsqldb.sourceforge.net/";>Simple SQL database</a>
+</td>
+<td colspan="1" rowspan="1">hsqldb/lib/hsqldb-1.7.1.jar</td>
+<td colspan="1" rowspan="1">hsqldb is a relational database engine written
in Java, with a JDBC
+ driver, supporting a subset of ANSI-92 SQL. It offers a small, fast
+ database engine which offers both in memory and disk based
tables.</td>
+<td colspan="1" rowspan="1">Cocoon samples webapp</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/poi/";>Create proprietary file formats</a>
+</td>
+<td colspan="1" rowspan="1">poi/lib/jakarta-poi-1.10.0-dev-20030222.jar</td>
+<td colspan="1" rowspan="1">
+ The POI project consists of APIs for manipulating
+ various file formats based upon Microsoft's OLE 2 Compound Document
+ format using pure Java.
+ </td>
+<td colspan="1" rowspan="1">MS Excel serializer (poi block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.hpl.hp.com/semweb/jena-top.html";>Jena RDF framework</a>
+</td>
+<td colspan="1" rowspan="1">deli/lib/jena-1.4.0.jar</td>
+<td colspan="1" rowspan="1">Jena is a java API for manipulating RDF
models.</td>
+<td colspan="1" rowspan="1">DELI (deli block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.coyotegulch.com/algorithm/jisp/index.html";>JISP</a>
+</td>
+<td colspan="1" rowspan="1">core/jisp-2.0.1.jar</td>
+<td colspan="1" rowspan="1"></td>
+<td colspan="1" rowspan="1">JISP file storage</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.redrival.com/greenrd/java/jstyle/";>Java Formatter</a>
+</td>
+<td colspan="1" rowspan="1">optional/jstyle.jar</td>
+<td colspan="1" rowspan="1">This program formats Java code with consistent
indentation and so
+ forth, to make it easier to read and maintain.</td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://lempinen.net/sami/jtidy/";>Transform HTML to XML</a>
+</td>
+<td colspan="1" rowspan="1">html/lib/jtidy-04aug2000r7-dev.jar</td>
+<td colspan="1" rowspan="1">Tidy is a HTML syntax checker and pretty
printer.</td>
+<td colspan="1" rowspan="1">HTML generator (html block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/lucene/";>Search engine</a>
+</td>
+<td colspan="1" rowspan="1">lucene/lib/lucene-1.2.jar</td>
+<td colspan="1" rowspan="1">jakarta-lucene is a search engine toolkit
designed for
+ indexing and searching of documents.</td>
+<td colspan="1" rowspan="1">Lucene block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://pizzacompiler.sourceforge.net/";>Java compiler</a>
+</td>
+<td colspan="1" rowspan="1">optional/pizza-1.1.jar</td>
+<td colspan="1" rowspan="1">Java Compiler</td>
+<td colspan="1" rowspan="1">XSP</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://sourceforge.net/projects/rdf-filter";>XML RDF parser</a>
+</td>
+<td colspan="1" rowspan="1">deli/lib/rdffilter.jar</td>
+<td colspan="1" rowspan="1"></td>
+<td colspan="1" rowspan="1">DELI (deli block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://xml.apache.org/commons/";>XML Catalog Entity Resolver</a>
+</td>
+<td colspan="1" rowspan="1">core/resolver-20021114.jar</td>
+<td colspan="1" rowspan="1">Maps URIs to other URIs using the mechanisms
defined by
+ OASIS Catalog or XML Catalog. Mainly used for DTDs and character
+ entity sets.
+ </td>
+<td colspan="1" rowspan="1">Cocoon Role entity-resolver</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/tomcat/";>Servlet API</a>
+</td>
+<td colspan="1" rowspan="1">optional/servlet_2_2.jar</td>
+<td colspan="1" rowspan="1"></td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/velocity/";>Velocity engine</a>
+</td>
+<td colspan="1" rowspan="1">velocity/lib/velocity-1.4-dev-20030301.jar</td>
+<td colspan="1" rowspan="1">Velocity is a general purpose template engine
written in Java.</td>
+<td colspan="1" rowspan="1">Velocity Generator (velocity block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.xmldb.org/";>XML DB APIs</a>
+</td>
+<td colspan="1" rowspan="1">xmldb/lib/xmldb-api-20011111.jar</td>
+<td colspan="1" rowspan="1">Database tailored for the storage of XML
data.</td>
+<td colspan="1" rowspan="1">XML:DB source (xmldb block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/commons/jxpath/";>Jakarta Commons
JXPath</a>
+</td>
+<td colspan="1" rowspan="1">core/commons-jxpath-1.1.jar</td>
+<td colspan="1" rowspan="1">XPath interpreter. Work with JavaBeans and DOM
nodes</td>
+<td colspan="1" rowspan="1">Flow, JXPath logicsheet, and XMLForm</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.eclipse.org/jdt";>Eclipse Java Development Tools Core</a>
+</td>
+<td colspan="1" rowspan="1">optional/jdtcore-2.1.0.jar</td>
+<td colspan="1" rowspan="1">Eclipse Java Compiler</td>
+<td colspan="1" rowspan="1">XSP</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a
href="http://cvs.cocoondev.org/cgi-bin/viewcvs.cgi/?cvsroot=rhino";>Continuations-based
JavaScript engine</a>
+</td>
+<td colspan="1" rowspan="1">core/rhino1.5r4-continuations-20030605.jar</td>
+<td colspan="1" rowspan="1">Rhino is an implementation of JavaScript in
Java.</td>
+<td colspan="1" rowspan="1">Control flow</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.tivano.de/software/spark/";>Spark</a>
+</td>
+<td colspan="1" rowspan="1">swf/lib/spark.jar</td>
+<td colspan="1" rowspan="1">Spark is XML2SWF and SWF2XML converter</td>
+<td colspan="1" rowspan="1">SWF Serializer (swf block)</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://chaperon.sourceforge.net";>Chaperon Text Parser</a>
+</td>
+<td colspan="1" rowspan="1">chaperon/lib/chaperon-20030407.jar</td>
+<td colspan="1" rowspan="1">
+ The chaperon project is parser which could parse text files, and
+ convert those to XML files.
+ </td>
+<td colspan="1" rowspan="1">Chaperon block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://castor.exolab.org";>Castor</a>
+</td>
+<td colspan="1" rowspan="1">optional/castor-0.9.4.3-xml.jar</td>
+<td colspan="1" rowspan="1"></td>
+<td colspan="1" rowspan="1">CastorTransformer and precept</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.jaxen.org/";>Jaxen</a>
+</td>
+<td colspan="1" rowspan="1">optional/jaxen-core-1.0-FCS.jar</td>
+<td colspan="1" rowspan="1"> The Jaxen project is a Java XPath Engine. Jaxen
is a universal object model walker, capable of evaluating XPath expressions
across multiple models. Currently supported are dom4j and JDOM.</td>
+<td colspan="1" rowspan="1">core</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.jaxen.org/";>Jaxen Dom</a>
+</td>
+<td colspan="1" rowspan="1">optional/jaxen-dom-1.0-FCS.jar</td>
+<td colspan="1" rowspan="1"> The Jaxen project is a Java XPath Engine. Jaxen
is a universal object model walker, capable of evaluating XPath expressions
across multiple models. Currently supported are dom4j and JDOM.</td>
+<td colspan="1" rowspan="1">core</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://sourceforge.net/projects/saxpath/";>SaxPath</a>
+</td>
+<td colspan="1" rowspan="1">optional/saxpath-1.0-FCS.jar</td>
+<td colspan="1" rowspan="1">SAXPath is a Java XPath engine for use on a
variety of XML object models including dom4j, DOM and JavaBeans.</td>
+<td colspan="1" rowspan="1">core</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/slide/";>Slide kernel</a>
+</td>
+<td colspan="1" rowspan="1">slide/lib/slide-kernel-20030322.jar</td>
+<td colspan="1" rowspan="1">The Jakarta Slide kernel API.</td>
+<td colspan="1" rowspan="1">Slide block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/slide/";>Slide roles</a>
+</td>
+<td colspan="1" rowspan="1">slide/lib/slide-roles-20030322.jar</td>
+<td colspan="1" rowspan="1">The Jakarta Slide roles implementation.</td>
+<td colspan="1" rowspan="1">Slide block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/slide/";>Slide stores</a>
+</td>
+<td colspan="1" rowspan="1">slide/lib/slide-stores-20030322.jar</td>
+<td colspan="1" rowspan="1">The Jakarta Slide stores implementation.</td>
+<td colspan="1" rowspan="1">Slide block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/slide/";>Slide WebDAV Servlet</a>
+</td>
+<td colspan="1" rowspan="1">slide/lib/slide-webdavservlet-20030322.jar</td>
+<td colspan="1" rowspan="1">The Jakarta Slide WebDAV servlet.</td>
+<td colspan="1" rowspan="1">Slide block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://www.jdom.org/";>JDOM</a>
+</td>
+<td colspan="1" rowspan="1">optional/jdom-dev-20020131.jar</td>
+<td colspan="1" rowspan="1">JDOM</td>
+<td colspan="1" rowspan="1">Slide block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="jars.html__">WSDL</a>
+</td>
+<td colspan="1" rowspan="1">axis/lib/wsdl4j.jar</td>
+<td colspan="1" rowspan="1">???</td>
+<td colspan="1" rowspan="1">Axis block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="jars.html__">???</a>
+</td>
+<td colspan="1" rowspan="1">axis/lib/axis-saaj-1.1.jar</td>
+<td colspan="1" rowspan="1">???</td>
+<td colspan="1" rowspan="1">Axis block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="jars.html__">Avalon Excalibur Util</a>
+</td>
+<td colspan="1" rowspan="1">axis/lib/excalibur-util-1.0.jar</td>
+<td colspan="1" rowspan="1">???</td>
+<td colspan="1" rowspan="1">Axis block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="jars.html__">???</a>
+</td>
+<td colspan="1" rowspan="1">axis/lib/commons-discovery.jar</td>
+<td colspan="1" rowspan="1">???</td>
+<td colspan="1" rowspan="1">Axis block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="jars.html__">???</a>
+</td>
+<td colspan="1" rowspan="1">axis/lib/axis-jaxrpc-1.1.jar</td>
+<td colspan="1" rowspan="1">???</td>
+<td colspan="1" rowspan="1">Axis block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="jars.html__">???</a>
+</td>
+<td colspan="1" rowspan="1">axis/lib/axis-1.1.jar</td>
+<td colspan="1" rowspan="1">???</td>
+<td colspan="1" rowspan="1">Axis block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/commons/lang/";>Jakarta Commons lang</a>
+</td>
+<td colspan="1" rowspan="1">core/commons-lang-1.0.1.jar</td>
+<td colspan="1" rowspan="1">
+ Part of jakarta-commons, it's a package that
+ provides extended services on base classes of the JDK,
+ such as unrolling exceptions.
+ </td>
+<td colspan="1" rowspan="1">Cocoon</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://xreporter.cocoondev.org";>xReporter expression language
interpreter</a>
+</td>
+<td colspan="1" rowspan="1">woody/lib/xreporter-expression-20030428.jar</td>
+<td colspan="1" rowspan="1">
+ An expression language interpreter.
+ </td>
+<td colspan="1" rowspan="1">Woody block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://jakarta.apache.org/oro";>ORO</a>
+</td>
+<td colspan="1" rowspan="1">woody/lib/jakarta-oro-2.0.7.jar</td>
+<td colspan="1" rowspan="1">
+ Regular expression engine.
+ </td>
+<td colspan="1" rowspan="1">Woody block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://joost.sourceforge.net/";>Joost</a>
+</td>
+<td colspan="1" rowspan="1">stx/lib/joost-20030502.jar</td>
+<td colspan="1" rowspan="1">Streaming Transformation for XML (STX)
library</td>
+<td colspan="1" rowspan="1">STX block</td>
+
+</tr>
+
+<tr>
+
+<td colspan="1" rowspan="1">
+<a href="http://qdox.codehaus.org";>QDox - Quick JavaDoc Scanner</a>
+</td>
+<td colspan="1" rowspan="1">qdox/lib/qdox-1.1.jar</td>
+<td colspan="1" rowspan="1">
+ QDox is a high speed, small footprint parser for extracting
class/interface/method
+ definitions from source files complete with JavaDoc @tags.
+ </td>
+<td colspan="1" rowspan="1">QDoxSource (qdox block)</td>
+
+</tr>
+
+</table>
+</div>
+
+</div>
+</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end Content==================-->
+</table>
+</td>
+</tr>
+</table>
+<!--================= end Menu, NavBar, Content ==================-->
+<!--================= start Footer ==================-->
+<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
+<tr>
+<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="../skin/images/spacer.gif" class="spacer"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
+</tr>
+<tr>
+<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
+ 1999-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
+ document.write(" - "+"Last Published: " +
document.lastModified);
+ // --></script></font></td>
+</tr>
+<tr>
+<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
+</tr>
+</table>
+<!--================= end Footer ==================-->
+</body>
+</html>
1.2 +1684 -58 cocoon-site/site/2.1/installing/jars.pdf
<<Binary file>>
1.5 +270 -270 cocoon-site/site/2.1/installing/tests.html
Index: tests.html
===================================================================
RCS file: /home/cvs/cocoon-site/site/2.1/installing/tests.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- tests.html 21 May 2003 15:23:24 -0000 1.4
+++ tests.html 9 Jul 2003 16:58:55 -0000 1.5
@@ -1,270 +1,270 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Testing your Apache Cocoon</title>
-<link type="text/css" href="../skin/page.css" rel="stylesheet">
-</head>
-<body text="#000000" bgcolor="#FFFFFF">
-<!--================= start Navigation Path ==================-->
-<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<tr>
-<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" border="0"
src="../skin/images/spacer.gif"><!--===== breadcrumb trail
(javascript-generated) ====--><font size="2" face="Arial, Helvetica,
Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0"
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Navigation Path ==================-->
-<!--================= start Banner ==================-->
-<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<tr>
-<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://xml.apache.org";><img border="0"
class="logoImage" alt="Apache Cocoon" src="../images/group-logo.gif"></a></td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache
Cocoon" src="../images/project-logo.gif"></a></td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
-<form target="_blank" action="http://www.google.com/search"; method="get">
-<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
-<tr>
-<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td><td nowrap="nowrap"><input
value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15"
name="q" id="query" type="text"><img height="1" width="5" alt=""
src="../skin/images/spacer.gif"><input name="Search" value="Search"
type="submit">
-<br>
-<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
- the Apache Cocoon site
-
-
- </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10"
width="9" src="../skin/images/search-right.gif"></td>
-</tr>
-</table>
-</form>
-</td>
-<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" bgcolor="#294563" colspan="2">
-<!--================= start Tabs ==================-->
-<div class="tab">
-<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td width="8"><img alt="" height="8" width="8"
src="../skin/images/spacer.gif"></td><td valign="bottom">
-<table summary="selected tab" style="height: 1.7em" border="0"
cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a href="../index.html"><font
color="#000000">Home</font></a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-</div>
-<!--================= end Tabs ==================-->
-</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Banner ==================-->
-<!--================= start Menu, NavBar, Content ==================-->
-<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top">
-<table summary="menu" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<!--================= start left top NavBar ==================-->
-<td rowspan="3" valign="top">
-<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
-</tr>
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td>
-<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img
width="10" height="10" alt="" src="../skin/images/spacer.gif"></td><td
nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
-<!--================= start Menu items ==================-->
-<div class="menu">
-<ul>
-<li>
-<font color="#CFDCED">Navigation</font>
-<ul>
-
-<li>
-<a href="../index.html">Main</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Installation</font>
-<ul>
-
-<li>
-<a target="_blank" href="http://cocoon.apache.org/mirror.cgi";>Download</a>
-</li>
-
-<li>
-<a href="index.html">Installing</a>
-</li>
-
-<li>
-<a href="updating.html">Updating</a>
-</li>
-
-<li>
-<a href="jars.html">Jars</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Testing</font>
-<ul>
-
-<li>
-<span class="sel"><font color="#ffcc00">Overview</font></span>
-</li>
-
-</ul>
-</li>
-</ul>
-</div>
-<!--================= end Menu items ==================-->
-</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="../skin/images/spacer.gif"></td><td bgcolor="#294563"><img
width="1" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" border="0" alt="" src="../skin/images/spacer.gif"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
-</tr>
-<tr>
-<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td><td valign="top" width="100%">
-<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<!--================= start middle NavBar ==================-->
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif"></td><td align="left" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
-
- </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif"></td><td align="right" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
-
- </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img
width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end middle NavBar ==================-->
-<!--================= start Content==================-->
-<tr>
-<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td><td align="left" width="100%">
-<div class="content">
-<table class="title" summary="">
-<tr>
-<td valign="middle">
-<h1>Testing your Apache Cocoon</h1>
-</td><script Language="Javascript">
-
-function printit(){
-if (window.print) {
- window.print() ;
-} else {
- var WebBrowser = '<OBJECT
CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0"
ID="WebBrowser1"></OBJECT>';
-document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
- WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box
WebBrowser1.outerHTML = "";
-}
-}
-</script><script Language="Javascript">
-var NS = (navigator.appName == "Netscape");
-var VERSION = parseInt(navigator.appVersion);
-if (VERSION > 3) {
- document.write('<td nowrap="nowrap" width="40" align="center">');
- document.write(' <a class="dida" href="javascript:printit()">');
- document.write(' <img alt="Print this Page"
src="../skin/images/printer.gif" border="0"><br>');
- document.write(' print</a>');
- document.write('</td>');
-}
-</script><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="tests.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" border="0"><br>
- PDF</a></td>
-</tr>
-</table>
-<p>
-<font size="-2">by David Crossley</font>
-</p>
-<ul class="minitoc">
-<li>
-<a href="#Overview+of+testing+procedures">Overview of testing procedures</a>
-</li>
-</ul>
-
-<a name="N10019"></a><a name="Overview+of+testing+procedures"></a>
-<h3>Overview of testing procedures</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- There are some initial procedures available for you to ensure that
- Apache Cocoon can run properly on your particular computing platform.
- (You can build upon this infrastructure to add your own tests.)
- </p>
-<ul>
-
-<li>
- Run "<span class="codefrag">build test</span>" to conduct an initial set
of
- automated JUnit test cases,
- e.g. test the methods for getting platform-dependent filesystem
pathnames;
- e.g. ensure that Catalog Entity Resolver works properly
- </li>
-
-</ul>
-<p>Other tests ...</p>
-<ul>
-
-<li>
-
-<a href="../catalog-test.html">Testing: Catalog Entity Resolver</a>
- which conducts some additional tests for resolving external entities.
- </li>
-
-</ul>
-</div>
-
-
-</div>
-</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end Content==================-->
-</table>
-</td>
-</tr>
-</table>
-<!--================= end Menu, NavBar, Content ==================-->
-<!--================= start Footer ==================-->
-<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
-<tr>
-<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="../skin/images/spacer.gif"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
-</tr>
-<tr>
-<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
- 1999-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
- document.write(" - "+"Last Published: " +
document.lastModified);
- // --></script></font></td>
-</tr>
-<tr>
-<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
-</tr>
-</table>
-<!--================= end Footer ==================-->
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Testing your Apache Cocoon</title>
+<link type="text/css" href="../skin/page.css" rel="stylesheet">
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<!--================= start Navigation Path ==================-->
+<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font
size="2" face="Arial, Helvetica, Sans-serif"><script
src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Navigation Path ==================-->
+<!--================= start Banner ==================-->
+<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<!--================= start Group Logo ==================-->
+<td bgcolor="#294563"><a href=""></a></td>
+<!--================= end Group Logo ==================-->
+<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache
Cocoon" src="../images/project-logo.gif"></a></td>
+<!--================= end Project Logo ==================-->
+<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
+<form target="_blank" action="http://www.google.com/search"; method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
+<tr>
+<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"
class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org"
name="sitesearch" type="hidden"><input size="15" name="q" id="query"
type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><input name="Search" value="Search" type="submit">
+<br>
+<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
+ the Apache Cocoon site
+
+
+ </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0"
height="10" width="9" src="../skin/images/search-right.gif"></td>
+</tr>
+</table>
+</form>
+</td>
+<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" bgcolor="#294563" colspan="2">
+<!--================= start Tabs ==================-->
+<div class="tab">
+<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td width="6"><img alt="" height="8" width="6"
src="../skin/images/spacer.gif"></td><td valign="bottom">
+<table summary="selected tab" style="height: 1.8em" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a href="../index.html"><font
color="#000000">Home</font></a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</div>
+<!--================= end Tabs ==================-->
+</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Banner ==================-->
+<!--================= start Menu, NavBar, Content ==================-->
+<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top">
+<table summary="menu" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<!--================= start left top NavBar ==================-->
+<td rowspan="3" valign="top">
+<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
+</tr>
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td>
+<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom"
bgcolor="#4C6C8F"><img width="10" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"
valign="top" bgcolor="#4C6C8F">
+<!--================= start Menu items ==================-->
+<div class="menu">
+<ul>
+<li>
+<font color="#CFDCED">Navigation</font>
+<ul>
+
+<li>
+<a href="../index.html">Main</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Installation</font>
+<ul>
+
+<li>
+<a target="_blank" href="http://cocoon.apache.org/mirror.cgi";>Download</a>
+</li>
+
+<li>
+<a href="index.html">Installing</a>
+</li>
+
+<li>
+<a href="updating.html">Updating</a>
+</li>
+
+<li>
+<a href="jars.html">Jars</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Testing</font>
+<ul>
+
+<li>
+<span class="sel"><font color="#ffcc00">Overview</font></span>
+</li>
+
+</ul>
+</li>
+</ul>
+</div>
+<!--================= end Menu items ==================-->
+</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
+</tr>
+<tr>
+<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td><td valign="top" width="100%">
+<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<!--================= start middle NavBar ==================-->
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="right"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td width="10"
bgcolor="#CFDCED"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end middle NavBar ==================-->
+<!--================= start Content==================-->
+<tr>
+<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="100%">
+<div class="content">
+<table class="title" summary="">
+<tr>
+<td valign="middle">
+<h1>Testing your Apache Cocoon</h1>
+</td><script Language="Javascript">
+
+function printit(){
+if (window.print) {
+ window.print() ;
+} else {
+ var WebBrowser = '<OBJECT
CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0"
ID="WebBrowser1"></OBJECT>';
+document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
+ WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box
WebBrowser1.outerHTML = "";
+}
+}
+</script><script Language="Javascript">
+var NS = (navigator.appName == "Netscape");
+var VERSION = parseInt(navigator.appVersion);
+if (VERSION > 3) {
+ document.write('<td nowrap="nowrap" width="40" align="center">');
+ document.write(' <a class="dida" href="javascript:printit()">');
+ document.write(' <img alt="Print this Page"
src="../skin/images/printer.gif" class="skin"><br>');
+ document.write(' print</a>');
+ document.write('</td>');
+}
+</script><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="tests.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
class="skin"><br>
+ PDF</a></td>
+</tr>
+</table>
+<p>
+<font size="-2">by David Crossley</font>
+</p>
+<ul class="minitoc">
+<li>
+<a href="#Overview+of+testing+procedures">Overview of testing procedures</a>
+</li>
+</ul>
+
+<a name="N10019"></a><a name="Overview+of+testing+procedures"></a>
+<h3>Overview of testing procedures</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ There are some initial procedures available for you to ensure that
+ Apache Cocoon can run properly on your particular computing platform.
+ (You can build upon this infrastructure to add your own tests.)
+ </p>
+<ul>
+
+<li>
+ Run "<span class="codefrag">build test</span>" to conduct an initial set
of
+ automated JUnit test cases,
+ e.g. test the methods for getting platform-dependent filesystem
pathnames;
+ e.g. ensure that Catalog Entity Resolver works properly
+ </li>
+
+</ul>
+<p>Other tests ...</p>
+<ul>
+
+<li>
+
+<a href="../catalog-test.html">Testing: Catalog Entity Resolver</a>
+ which conducts some additional tests for resolving external entities.
+ </li>
+
+</ul>
+</div>
+
+
+</div>
+</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end Content==================-->
+</table>
+</td>
+</tr>
+</table>
+<!--================= end Menu, NavBar, Content ==================-->
+<!--================= start Footer ==================-->
+<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
+<tr>
+<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="../skin/images/spacer.gif" class="spacer"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
+</tr>
+<tr>
+<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
+ 1999-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
+ document.write(" - "+"Last Published: " +
document.lastModified);
+ // --></script></font></td>
+</tr>
+<tr>
+<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
+</tr>
+</table>
+<!--================= end Footer ==================-->
+</body>
+</html>
1.2 +44 -100 cocoon-site/site/2.1/installing/tests.pdf
<<Binary file>>
1.6 +595 -433 cocoon-site/site/2.1/installing/updating.html
Index: updating.html
===================================================================
RCS file: /home/cvs/cocoon-site/site/2.1/installing/updating.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- updating.html 21 May 2003 17:47:57 -0000 1.5
+++ updating.html 9 Jul 2003 16:58:55 -0000 1.6
@@ -1,433 +1,595 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Updating Cocoon</title>
-<link type="text/css" href="../skin/page.css" rel="stylesheet">
-</head>
-<body text="#000000" bgcolor="#FFFFFF">
-<!--================= start Navigation Path ==================-->
-<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<tr>
-<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" border="0"
src="../skin/images/spacer.gif"><!--===== breadcrumb trail
(javascript-generated) ====--><font size="2" face="Arial, Helvetica,
Sans-serif"><script src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0"
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Navigation Path ==================-->
-<!--================= start Banner ==================-->
-<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<tr>
-<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://xml.apache.org";><img border="0"
class="logoImage" alt="Apache Cocoon" src="../images/group-logo.gif"></a></td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache
Cocoon" src="../images/project-logo.gif"></a></td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
-<form target="_blank" action="http://www.google.com/search"; method="get">
-<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
-<tr>
-<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td><td nowrap="nowrap"><input
value="cocoon.apache.org" name="sitesearch" type="hidden"><input size="15"
name="q" id="query" type="text"><img height="1" width="5" alt=""
src="../skin/images/spacer.gif"><input name="Search" value="Search"
type="submit">
-<br>
-<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
- the Apache Cocoon site
-
-
- </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif"></td><td><img alt="" border="0" height="10"
width="9" src="../skin/images/search-right.gif"></td>
-</tr>
-</table>
-</form>
-</td>
-<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" bgcolor="#294563" colspan="2">
-<!--================= start Tabs ==================-->
-<div class="tab">
-<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td width="8"><img alt="" height="8" width="8"
src="../skin/images/spacer.gif"></td><td valign="bottom">
-<table summary="selected tab" style="height: 1.7em" border="0"
cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a href="../index.html"><font
color="#000000">Home</font></a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-</div>
-<!--================= end Tabs ==================-->
-</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-<!--================= end Banner ==================-->
-<!--================= start Menu, NavBar, Content ==================-->
-<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
-<tr>
-<td valign="top">
-<table summary="menu" border="0" cellspacing="0" cellpadding="0">
-<tr>
-<!--================= start left top NavBar ==================-->
-<td rowspan="3" valign="top">
-<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
-</tr>
-<tr>
-<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td>
-<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img
width="10" height="10" alt="" src="../skin/images/spacer.gif"></td><td
nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
-<!--================= start Menu items ==================-->
-<div class="menu">
-<ul>
-<li>
-<font color="#CFDCED">Navigation</font>
-<ul>
-
-<li>
-<a href="../index.html">Main</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Installation</font>
-<ul>
-
-<li>
-<a target="_blank" href="http://cocoon.apache.org/mirror.cgi";>Download</a>
-</li>
-
-<li>
-<a href="index.html">Installing</a>
-</li>
-
-<li>
-<span class="sel"><font color="#ffcc00">Updating</font></span>
-</li>
-
-<li>
-<a href="jars.html">Jars</a>
-</li>
-
-</ul>
-</li>
-<li>
-<font color="#CFDCED">Testing</font>
-<ul>
-
-<li>
-<a href="tests.html">Overview</a>
-</li>
-
-</ul>
-</li>
-</ul>
-</div>
-<!--================= end Menu items ==================-->
-</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="../skin/images/spacer.gif"></td><td bgcolor="#294563"><img
width="1" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" border="0" alt="" src="../skin/images/spacer.gif"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
-</tr>
-<tr>
-<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-</table>
-</td><td valign="top" width="100%">
-<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<!--================= start middle NavBar ==================-->
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif"></td><td align="left" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
-
- </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif"></td><td align="right" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
-
- </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img
width="10" height="1" alt="" src="../skin/images/spacer.gif"></td>
-</tr>
-<tr>
-<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end middle NavBar ==================-->
-<!--================= start Content==================-->
-<tr>
-<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td><td align="left" width="100%">
-<div class="content">
-<table class="title" summary="">
-<tr>
-<td valign="middle">
-<h1>Updating Cocoon</h1>
-</td><script Language="Javascript">
-
-function printit(){
-if (window.print) {
- window.print() ;
-} else {
- var WebBrowser = '<OBJECT
CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0"
ID="WebBrowser1"></OBJECT>';
-document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
- WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box
WebBrowser1.outerHTML = "";
-}
-}
-</script><script Language="Javascript">
-var NS = (navigator.appName == "Netscape");
-var VERSION = parseInt(navigator.appVersion);
-if (VERSION > 3) {
- document.write('<td nowrap="nowrap" width="40" align="center">');
- document.write(' <a class="dida" href="javascript:printit()">');
- document.write(' <img alt="Print this Page"
src="../skin/images/printer.gif" border="0"><br>');
- document.write(' print</a>');
- document.write('</td>');
-}
-</script><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="updating.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
border="0"><br>
- PDF</a></td>
-</tr>
-</table>
-<p>
-<font size="-2">by Carsten Ziegeler</font>
-</p>
-<ul class="minitoc">
-<li>
-<a href="#Updating+Cocoon">Updating Cocoon</a>
-</li>
-<li>
-<a href="#Sitemap">Sitemap</a>
-<ul class="minitoc">
-<li>
-<a href="#FOP+Serializer">FOP Serializer</a>
-</li>
-</ul>
-</li>
-<li>
-<a href="#Components">Components</a>
-<ul class="minitoc">
-<li>
-<a href="#Source+Resolving">Source Resolving</a>
-</li>
-<li>
-<a href="#XSLT+Processor">XSLT Processor</a>
-</li>
-<li>
-<a href="#XML+Parser">XML Parser</a>
-</li>
-<li>
-<a href="#XML+Entity+Resolver">XML Entity Resolver</a>
-</li>
-<li>
-<a href="#Stores">Stores</a>
-</li>
-<li>
-<a href="#SAXConnectors%2C+Stream+and+Event+Pipeline">SAXConnectors, Stream
and Event Pipeline</a>
-</li>
-</ul>
-</li>
-</ul>
-
-
-<a name="N10013"></a><a name="Updating+Cocoon"></a>
-<h3>Updating Cocoon</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- This is a brief discussion of the changes between the latest official
release 2.0.4
- and the current development version of Apache Cocoon. So, if you are
interested in
- installing the official release, ignore this document. But if you want to
know what is going
- on in the development of Cocoon, have a look...
- </p>
-<p>
- Cocoon has developed many Avalon components which are of a more general
nature. So, the best
- solution was to donate these components to the Avalon Excalibur project
and move them out
- of Cocoon. This move has lead to some changes in configuration etc. which
are described
- by this document.
- </p>
-<p>In addition there were some disadvantages in the internal architecture of
Cocoon. The
- new version removes these bottlenecks and gives more flexibility,
usability and performance.
- </p>
-</div>
-
-<a name="N10022"></a><a name="Sitemap"></a>
-<h3>Sitemap</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>There are some changes in the sitemap and the configuration of some
components in
- the sitemap.</p>
-<a name="N1002A"></a><a name="FOP+Serializer"></a>
-<h4>FOP Serializer</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>FOP serializer's <user-config> relative path now resolves relative
- to sitemap's directory. All Cocoon URIs are supported too.
- </p>
-</div>
-</div>
-
-<a name="N10034"></a><a name="Components"></a>
-<h3>Components</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- The Cocoon architecture has had some significant changes. However, great
care has been
- taken that all changes are in a compatible way. This effort has been
successful except
- one change which shouldn't affect anybody (see below).
- </p>
-<a name="N1003C"></a><a name="Source+Resolving"></a>
-<h4>Source Resolving</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Under Cocoon 2.0.x, the SourceResolver was not an Avalon component, so it
could not be looked up using a component manager. Under 2.1, the SourceResolver
is now an Avalon component and can be requested using
<em>cocoon.manager.lookup(SourceResolver.ROLE).</em>
-</p>
-</div>
-<a name="N10047"></a><a name="XSLT+Processor"></a>
-<h4>XSLT Processor</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>Mention changes and update strategy...</p>
-</div>
-<a name="N10050"></a><a name="XML+Parser"></a>
-<h4>XML Parser</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>The XML parser has also been moved to Excalibur.
- In the cocoon.xconf the hint name has therefore changed from
<em>parser</em> to
- <em>xml-parser</em>. The configuration has not changed, so if you want
to
- manually update swap the hint names.</p>
-<p>From within your source code you should not lookup the
- <em>org.apache.cocoon.components.parser.Parser.ROLE</em> anymore; use
- <em>org.apache.excalibur.xml.sax.SAXParser.ROLE</em> instead.
- </p>
-</div>
-<a name="N10068"></a><a name="XML+Entity+Resolver"></a>
-<h4>XML Entity Resolver</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>The resolver used for resolving XML entities has also been moved to
Excalibur.
- In the cocoon.xconf the hint name has therefore changed from
<em>resolver</em> to
- <em>entity-resolver</em>. The configuration has not changed, so if you
want to
- manually update swap the hint names and the implementation.</p>
-<p>From within your source code you should not lookup the
- <em>org.apache.cocoon.components.resolver.Resolver.ROLE</em> anymore;
use
- <em>org.apache.excalibur.xml.EntityResolver.ROLE</em> instead.
- </p>
-</div>
-<a name="N10080"></a><a name="Stores"></a>
-<h4>Stores</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>The Store and StoreJanitor components and implementations have moved to
- Avalon Excalibur.</p>
-<p>TODO:Changes in cocoon.xconf...</p>
-<p>In general the packages changed from org.apache.cocoon.components.store
- to org.apache.excalibur.store (resp.
org.apache.excalibur.store.impl). So
- if you have custom java code using this components, you have to change
- your imports.</p>
-<p>The roles PERSISTENT_CACHE and TRANSIENT_CACHE have been renamed to
- PERSISTENT_STORE and TRANSIENT_STORE. The hold() method has been
removed
- from the Store interface.</p>
-</div>
-<a name="N10092"></a><a
name="SAXConnectors%2C+Stream+and+Event+Pipeline"></a>
-<h4>SAXConnectors, Stream and Event Pipeline</h4>
-<div style="margin-left: 0 ; border: 2px">
-<p>This is the only real incompatible change (But don't panic, this will
- not affect you, well at least only a little bit :). The internal
architecture of Cocoon
- has changed. In the older version, the processing pipeline -
constructed by
- a generator, the transformers and a serializer - was represented by
two components,
- called stream and event pipeline.</p>
-<p>For a simpler architecture, enhanced functionality and improved
performance,
- these components have been combined into one: the processing pipeline.
- The very rarely used feature of SAXConnectors has been removed,
- to avoid overcomponentization.</p>
-<p>In addition the map:pipeline element of the sitemap has gained more
meaning
- as it is now possible to configure each map:pipeline section in the
sitemap
- differently. So there can be one section using caching, another one
not
- caching at all and a third one using a different caching
implementation etc.
- </p>
-<a name="N100A0"></a><a name="Changed+Configuration"></a>
-<h5>Changed Configuration</h5>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- The configuration of the pipelines has moved from the cocoon.xconf to
the sitemap.
- So, for updating you have to remove the "event-pipeline" and
"stream-pipeline" section
- from your cocoon.xconf and add the map:pipes section to the
map:components section
- in your sitemap. You can find the pipelines components definition in
the sample
- sitemap of Cocoon. Here is an example:
- </p>
-<pre class="code">
-<map:sitemap>
- <map:components>
- ...
- <map:pipes default="caching">
- <map:pipe name="caching"
-
src="org.apache.cocoon.components.pipeline.impl.CachingProcessingPipeline"/>
- <map:pipe name="noncaching"
-
src="org.apache.cocoon.components.pipeline.impl.NonCachingProcessingPipeline"/>
- </map:pipes>
- </map:components>
- ...
-</map:sitemap>
- </pre>
-<p>The configuration is similar to the configuration of other sitemap
components, like
- generators or actions. You can choose these different implementations
of pipelines
- in the map:pipeline section by specifying the type attribute:
- </p>
-<pre class="code">
-<map:sitemap>
- ...
- <map:pipelines>
- <map:pipeline type="noncaching">
- <map:match pattern="welcome">
- ...
- </map:match>
- ..
- </map:pipeline>
- </map:pipelines>
-</map:sitemap>
- </pre>
-<p>So again, this is similar to choosing the type of the generator or any
other sitemap
- component. If you omit the type attribute the default configuration
from the components
- section is used.
- </p>
-<p>The SAXConnectors have been removed, so if you manually upgrade you have
to remove
- the <em>sax-connectors</em> configuration from the
<em>cocoon.xconf</em>.</p>
-<p>So you see, although this is an incompatible change in the Java code, you
have only
- little to do to update your Cocoon installation.</p>
-</div>
-</div>
-</div>
-
-
-</div>
-</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif"></td>
-</tr>
-<!--================= end Content==================-->
-</table>
-</td>
-</tr>
-</table>
-<!--================= end Menu, NavBar, Content ==================-->
-<!--================= start Footer ==================-->
-<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
-<tr>
-<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="../skin/images/spacer.gif"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
-</tr>
-<tr>
-<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
- 1999-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
- document.write(" - "+"Last Published: " +
document.lastModified);
- // --></script></font></td>
-</tr>
-<tr>
-<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
-</tr>
-</table>
-<!--================= end Footer ==================-->
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Updating Cocoon</title>
+<link type="text/css" href="../skin/page.css" rel="stylesheet">
+</head>
+<body text="#000000" bgcolor="#FFFFFF">
+<!--================= start Navigation Path ==================-->
+<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><!--===== breadcrumb trail (javascript-generated) ====--><font
size="2" face="Arial, Helvetica, Sans-serif"><script
src="../skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Navigation Path ==================-->
+<!--================= start Banner ==================-->
+<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<tr>
+<!--================= start Group Logo ==================-->
+<td bgcolor="#294563"><a href=""></a></td>
+<!--================= end Group Logo ==================-->
+<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://cocoon.apache.org/";><img border="0" class="logoImage" alt="Apache
Cocoon" src="../images/project-logo.gif"></a></td>
+<!--================= end Project Logo ==================-->
+<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
+<form target="_blank" action="http://www.google.com/search"; method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
+<tr>
+<td colspan="3"><img height="10" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif"
class="spacer"></td><td nowrap="nowrap"><input value="cocoon.apache.org"
name="sitesearch" type="hidden"><input size="15" name="q" id="query"
type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif"
class="spacer"><input name="Search" value="Search" type="submit">
+<br>
+<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
+ the Apache Cocoon site
+
+
+ </font></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img alt="" border="0" height="10" width="9"
src="../skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td><img alt="" border="0"
height="10" width="9" src="../skin/images/search-right.gif"></td>
+</tr>
+</table>
+</form>
+</td>
+<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" bgcolor="#294563" colspan="2">
+<!--================= start Tabs ==================-->
+<div class="tab">
+<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td width="6"><img alt="" height="8" width="6"
src="../skin/images/spacer.gif"></td><td valign="bottom">
+<table summary="selected tab" style="height: 1.8em" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="../skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b><a href="../index.html"><font
color="#000000">Home</font></a></b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="../skin/images/tabSel-right.gif"></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</div>
+<!--================= end Tabs ==================-->
+</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+<!--================= end Banner ==================-->
+<!--================= start Menu, NavBar, Content ==================-->
+<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
+<tr>
+<td valign="top">
+<table summary="menu" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<!--================= start left top NavBar ==================-->
+<td rowspan="3" valign="top">
+<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td bgcolor="#CFDCED"><font color="#4C6C8F" size="4" face="Arial, Helvetica,
Sans-serif"> </font></td>
+</tr>
+<tr>
+<td bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td>
+<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td valign="bottom"
bgcolor="#4C6C8F"><img width="10" height="10" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"
valign="top" bgcolor="#4C6C8F">
+<!--================= start Menu items ==================-->
+<div class="menu">
+<ul>
+<li>
+<font color="#CFDCED">Navigation</font>
+<ul>
+
+<li>
+<a href="../index.html">Main</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Installation</font>
+<ul>
+
+<li>
+<a target="_blank" href="http://cocoon.apache.org/mirror.cgi";>Download</a>
+</li>
+
+<li>
+<a href="index.html">Installing</a>
+</li>
+
+<li>
+<span class="sel"><font color="#ffcc00">Updating</font></span>
+</li>
+
+<li>
+<a href="jars.html">Jars</a>
+</li>
+
+</ul>
+</li>
+<li>
+<font color="#CFDCED">Testing</font>
+<ul>
+
+<li>
+<a href="tests.html">Overview</a>
+</li>
+
+</ul>
+</li>
+</ul>
+</div>
+<!--================= end Menu items ==================-->
+</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td valign="bottom" align="left" colspan="2" rowspan="2"
bgcolor="#4C6C8F"><img height="10" width="10" border="0" alt=""
src="../skin/images/menu-left.gif"></td><td bgcolor="#4C6C8F"><img height="10"
width="10" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td
valign="bottom" align="right" colspan="2" rowspan="2" bgcolor="#4C6C8F"><img
height="10" width="10" border="0" alt=""
src="../skin/images/menu-right.gif"></td>
+</tr>
+<tr>
+<td height="1" bgcolor="#294563"><img width="1" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+</table>
+</td><td valign="top" width="100%">
+<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
+<!--================= start middle NavBar ==================-->
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="right"
width="50%" bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial,
Helvetica, Sans-serif">
+
+
+ </font><img width="10" height="8" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td width="10"
bgcolor="#CFDCED"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end middle NavBar ==================-->
+<!--================= start Content==================-->
+<tr>
+<td align="left" width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td><td align="left"
width="100%">
+<div class="content">
+<table class="title" summary="">
+<tr>
+<td valign="middle">
+<h1>Updating Cocoon</h1>
+</td><script Language="Javascript">
+
+function printit(){
+if (window.print) {
+ window.print() ;
+} else {
+ var WebBrowser = '<OBJECT
CLASSID="CLSID:8856F961-340A-11D0-A96B-00C04FD705A2" HEIGHT="0" WIDTH="0"
ID="WebBrowser1"></OBJECT>';
+document.body.insertAdjacentHTML('beforeEnd', WebBrowser);
+ WebBrowser1.ExecWB(6, 2);//Use a 1 vs. a 2 for a prompting dialog box
WebBrowser1.outerHTML = "";
+}
+}
+</script><script Language="Javascript">
+var NS = (navigator.appName == "Netscape");
+var VERSION = parseInt(navigator.appVersion);
+if (VERSION > 3) {
+ document.write('<td nowrap="nowrap" width="40" align="center">');
+ document.write(' <a class="dida" href="javascript:printit()">');
+ document.write(' <img alt="Print this Page"
src="../skin/images/printer.gif" class="skin"><br>');
+ document.write(' print</a>');
+ document.write('</td>');
+}
+</script><td nowrap="nowrap" width="40" align="center"><a class="dida"
href="updating.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
class="skin"><br>
+ PDF</a></td>
+</tr>
+</table>
+<p>
+<font size="-2">by Carsten Ziegeler, Jörg
Heinicke, Bertrand Delacrétaz</font>
+</p>
+<ul class="minitoc">
+<li>
+<a href="#Updating+Cocoon">Updating Cocoon</a>
+</li>
+<li>
+<a href="#Sitemap">Sitemap</a>
+<ul class="minitoc">
+<li>
+<a href="#Pipelines+configuration+in+the+sitemap">Pipelines configuration in
the sitemap</a>
+</li>
+<li>
+<a href="#Individual+configuration+of+pipelines">Individual configuration of
pipelines</a>
+</li>
+<li>
+<a href="#FOP+Serializer">FOP Serializer</a>
+</li>
+<li>
+<a href="#Namespace+changes">Namespace changes</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Changes+in+logging+interfaces+require+recompilation">Changes in
logging interfaces require recompilation</a>
+</li>
+<li>
+<a href="#Components">Components</a>
+<ul class="minitoc">
+<li>
+<a href="#Cocoon+Configuration+%28cocoon.xconf%29">Cocoon Configuration
(cocoon.xconf)</a>
+</li>
+<li>
+<a href="#Source+Resolver">Source Resolver</a>
+</li>
+<li>
+<a href="#XSLT+Processor">XSLT Processor</a>
+</li>
+<li>
+<a href="#XML+Parser">XML Parser</a>
+</li>
+<li>
+<a href="#XML+Entity+Resolver">XML Entity Resolver</a>
+</li>
+<li>
+<a href="#Stores">Stores</a>
+</li>
+<li>
+<a href="#SAXConnectors%2C+Stream+and+Event+Pipeline">SAXConnectors, Stream
and Event Pipeline</a>
+</li>
+<li>
+<a href="#File+Upload">File Upload</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Components+from+the+scratchpad">Components from the scratchpad</a>
+<ul class="minitoc">
+<li>
+<a href="#Session%2C+Authentication+and+Portal">Session, Authentication and
Portal</a>
+</li>
+</ul>
+</li>
+</ul>
+
+
+<a name="N1001B"></a><a name="Updating+Cocoon"></a>
+<h3>Updating Cocoon</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>Please take your time to read this document completely before trying to
upgrade from
+ a Cocoon 2.0.x installation to 2.1 (or above).</p>
+<p>
+ This is a brief discussion of the changes between the latest official
release 2.0.4
+ and the current development version of Apache Cocoon.
+ You only need this information if you are updating an existing Cocoon
installation, or
+ if you want to know what is going on in the development of Cocoon.
+ </p>
+<p>
+ The Cocoon team took great care in making this new version as compatible
as
+ possible. However, in order to achieve even more flexibility, usability
and
+ performance, the internal architecure of Cocoon has been improved. Due
to these
+ improvements it has not been possible to be compatible in every little
detail.
+ If you follow the instructions of document closely, however,
+ you should be able to quickly upgrade your Cocoon 2.0.x installation.
+ </p>
+<p>
+ The Cocoon team has developed many Avalon components that are not
specific to Cocoon
+ and therefore have been donated to the Avalon Excalibur project and moved
out
+ of Cocoon. This has led to some configuration changes which are also
described
+ in this document.
+ </p>
+</div>
+
+<a name="N1002D"></a><a name="Sitemap"></a>
+<h3>Sitemap</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>There are some changes in the sitemap and in the configuration of some
components in
+ the sitemap.</p>
+<a name="N10035"></a><a name="Pipelines+configuration+in+the+sitemap"></a>
+<h4>Pipelines configuration in the sitemap</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ The configuration of the pipelines has moved from cocoon.xconf to the
sitemap.
+ To update your installation, you have to remove the "event-pipeline"
and "stream-pipeline" section
+ from your cocoon.xconf and add the <span
class="codefrag">map:pipes</span> section to the <span
class="codefrag">map:components</span> section
+ of your sitemap. You can find the pipelines components definition in
the sample
+ main sitemap of Cocoon. Here is an example:
+ </p>
+<pre class="code">
+<map:sitemap>
+ <map:components>
+ ...
+ <map:pipes default="caching">
+ <map:pipe name="caching"
+
src="org.apache.cocoon.components.pipeline.impl.CachingProcessingPipeline"/>
+ <map:pipe name="noncaching"
+
src="org.apache.cocoon.components.pipeline.impl.NonCachingProcessingPipeline"/>
+ </map:pipes>
+ </map:components>
+ ...
+</map:sitemap>
+ </pre>
+<p>You can choose these different pipeline implementations
+ in the <span class="codefrag">map:pipeline</span> section by
specifying their <span class="codefrag">type</span> attribute:
+ </p>
+<pre class="code">
+<map:sitemap>
+ ...
+ <map:pipelines>
+ <map:pipeline type="noncaching">
+ <map:match pattern="welcome">
+ ...
+ </map:match>
+ ..
+ </map:pipeline>
+ </map:pipelines>
+</map:sitemap>
+ </pre>
+<p>This is similar to choosing the type of a generator or any other sitemap
+ component. If the type attribute is omitted, the default
configuration from the <span class="codefrag">map:components</span>
+ section is used.
+ </p>
+<p>The SAXConnectors have been removed, so if you upgrade manually you have
to remove
+ the <em>sax-connectors</em> configuration from
<em>cocoon.xconf</em>.</p>
+<p>So it's not that bad, despite incompatible changes in the Cocoon code
there is
+ little to do to update your Cocoon installation.</p>
+</div>
+<a name="N10069"></a><a name="Individual+configuration+of+pipelines"></a>
+<h4>Individual configuration of pipelines</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The sitemap now provides individual configuration of <span
class="codefrag">map:pipeline</span> sections.
+ You can now define one pipeline using caching, another one not using
+ caching at all and a third one using a different caching
implementation, for example.
+ </p>
+</div>
+<a name="N10075"></a><a name="FOP+Serializer"></a>
+<h4>FOP Serializer</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Relative paths in FOP serializer's <user-config> are now resolved
relatively
+ to the directory that contains the sitemap.</p>
+<p>All Cocoon URIs are supported too.</p>
+</div>
+<a name="N10081"></a><a name="Namespace+changes"></a>
+<h4>Namespace changes</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ In order to have consistent namespaces, some transformers
+ and generators (listed below) use new namespaces. If you use any of
these components, you will
+ need to use the new namespaces.
+ </p>
+<a name="N10089"></a><a name="Request+Generator"></a>
+<h5>Request Generator</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>RequestGenerator changed its namespace from
http://xml.apache.org/cocoon/requestgenerator/2.0 to
+ http://apache.org/cocoon/request/2.0.
+ </p>
+</div>
+<a name="N10092"></a><a name="I18nTransformer"></a>
+<h5>I18nTransformer</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>The I18nTransformer changed its namespace from
+ http://apache.org/cocoon/i18n/2.0 to
http://apache.org/cocoon/i18n/2.1</p>
+</div>
+</div>
+</div>
+
+<a name="N1009D"></a><a
name="Changes+in+logging+interfaces+require+recompilation"></a>
+<h3>Changes in logging interfaces require recompilation</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ Due to some interface changes in the Cocoon logging components,
custom java
+ components (generators,transformers or actions for example) compiled
for Cocoon 2.0.x will not run
+ under Cocoon 2.1 unless recompiled.</p>
+</div>
+
+<a name="N100A6"></a><a name="Components"></a>
+<h3>Components</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ The Cocoon architecture has changed significantly. However, great care
has been
+ taken to preserve backwards compatibility.
+ This effort has been successful except for
+ one change which shouldn't affect anybody (see below).
+ </p>
+<a name="N100AE"></a><a name="Cocoon+Configuration+%28cocoon.xconf%29"></a>
+<h4>Cocoon Configuration (cocoon.xconf)</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>In order to reflect the new version, the version information in the
<em>cocoon.xconf</em>
+ has changed from <em>2.0</em> to <em>2.1</em>.
+ </p>
+<p>To update <em>cocoon.xconf</em>, we recommend that you start with the new
cocoon.xconf from V2.1 and
+ incorporate your changes in it, instead of trying to migrate your old
configuration file.</p>
+</div>
+<a name="N100C6"></a><a name="Source+Resolver"></a>
+<h4>Source Resolver</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The SourceResolver is now an Avalon component
+ which can be accessed using
<em>cocoon.manager.lookup(SourceResolver.ROLE).</em>.
+ The package name of the component is
<em>org.apache.excalibur.source</em>.</p>
+</div>
+<a name="N100D5"></a><a name="XSLT+Processor"></a>
+<h4>XSLT Processor</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ The default XSLT processor has changed, and there are some issues
related to JDK 1.4
+ </p>
+<a name="N100DD"></a><a name="Xalan+vs.+XSLTC"></a>
+<h5>Xalan vs. XSLTC</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>The most important change is the switch from
+ <a href="http://xml.apache.org/xalan-j";>Xalan</a> to
+ <a href="http://xml.apache.org/xalan-j/xsltc_usage.html";>XSLTC</a> as
the default XSLT
+ processor (configured in the root sitemap in the <span
class="codefrag">map:components</span> section under
+ <span class="codefrag">map:transformers</span>).</p>
+<p>We decided to switch to XSLTC for performance reasons, but it might not
be as stable as
+ Xalan, and XSLTC's error messages are currently not as good as Xalan's.
+ </p>
+<p>
+ Bruno Dumon has queued a
+ <a
href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=20114";>patch</a>
+ for XSLTC, which improves error handling and will hopefully be applied
soon. For now, if you get error
+ messages like <em>"unable to create templates for stylesheet
..."</em>, simply switch the
+ processor to Xalan in the <span class="codefrag">map:transform</span>
element to get better error reporting (hopefully).
+ You don't necessarily need to switch the default processor, it can be
done individually for the transformation
+ that gives errors.
+ </p>
+</div>
+<a name="N10104"></a><a name="XML%2FXSLT+with+JDK+1.4"></a>
+<h5>XML/XSLT with JDK 1.4</h5>
+<div style="margin-left: 0 ; border: 2px">
+<p>Another serious issue is the presence of the Xalan and Xerces
+ package in the JDK 1.4. For general information on this please read
the
+ <a href="http://xml.apache.org/xalan-j/faq.html#jdk14";>Xalan FAQ</a>
and our own
+ <a
href="http://wiki.cocoondev.org/Wiki.jsp?page=EndorsedLibsProblem";>EndorsedLibsProblem</a>
+ wiki page.
+ </p>
+<p>
+ Basically, you have to update your libraries in the endorsed dirs of
the JDK
+ or the servlet containers with every new version of Xalan and Xerces
delivered with Cocoon.
+ Strange errors can occur if you have different versions of these
packages in the
+ classpath (independent of those in the JDK).
+ </p>
+</div>
+</div>
+<a name="N10119"></a><a name="XML+Parser"></a>
+<h4>XML Parser</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The XML parser component has been moved to Excalibur.
+ In cocoon.xconf, the hint name has therefore changed from
<em>parser</em> to
+ <em>xml-parser</em>. The configuration has not changed, so changing the
hint
+ names is sufficent.</p>
+<p>Java code should not use
+ <em>org.apache.cocoon.components.parser.Parser.ROLE</em> anymore; use
+ <em>org.apache.excalibur.xml.sax.SAXParser.ROLE</em> instead.
+ </p>
+</div>
+<a name="N10131"></a><a name="XML+Entity+Resolver"></a>
+<h4>XML Entity Resolver</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>Similarly, the XML entity resolver component has been moved to Excalibur.
+ In cocoon.xconf the hint name has therefore changed from
<em>resolver</em> to
+ <em>entity-resolver</em>. The configuration has not changed, so
changing the hint
+ names is sufficent.</p>
+<p>Java code should not use
+ <em>org.apache.cocoon.components.resolver.Resolver.ROLE</em> anymore;
use
+ <em>org.apache.excalibur.xml.EntityResolver.ROLE</em> instead.
+ </p>
+<p>The default entities (DTDs, entity sets, etc.) have moved to the
+ WEB-INF/ directory.
+ </p>
+</div>
+<a name="N1014C"></a><a name="Stores"></a>
+<h4>Stores</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The Store and StoreJanitor components and implementations have been moved
to
+ Avalon Excalibur.</p>
+<p>To make upgrading easier, the class attributes of the store janitor
+ component have been removed in <em>cocoon.xconf</em> as the class
names have changed.
+ The <em>cache-transient</em> and <em>cache-persistent</em> components
do
+ not exist anymore, so any reference to them must be removed from
cocoon.xconf.
+ Use the <em>persistent-store</em> and <em>transient-store</em>
components instead.
+ </p>
+<p>In general the package names changed from
<em>org.apache.cocoon.components.store</em>
+ to <em>org.apache.excalibur.store</em> (and
<em>org.apache.excalibur.store.impl</em>). So
+ if you have custom java code using these components, you have to
change
+ your imports.</p>
+<p>The roles <em>PERSISTENT_CACHE</em> and <em>TRANSIENT_CACHE</em> have
been renamed to
+ <em>PERSISTENT_STORE</em> and <em>TRANSIENT_STORE</em>. The hold()
method has been removed
+ from the Store interface.</p>
+</div>
+<a name="N10182"></a><a
name="SAXConnectors%2C+Stream+and+Event+Pipeline"></a>
+<h4>SAXConnectors, Stream and Event Pipeline</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>This is the only real incompatible change (But don't panic, this will
+ not affect you, or maybe just a little bit..).
+ </p>
+<p>
+ The internal architecture of Cocoon
+ has changed: previously, the processing pipeline - consisting of
+ a generator, the transformers and a serializer - was represented by
two components,
+ called <em>stream</em> and <em>event pipeline</em>.</p>
+<p>For a simpler architecture, enhanced functionality and improved
performance,
+ these components have been combined into one: the <em>processing
pipeline</em>.
+ The <em>SAXConnectors</em>, which were rarely used, have been removed
+ to avoid overcomponentization.</p>
+</div>
+<a name="N1019D"></a><a name="File+Upload"></a>
+<h4>File Upload</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The class name for file upload has changed from
<em>org.apache.cocoon.components.request.multipart.FilePart</em> to
+ <em>org.apache.cocoon.servlet.multipart.Part</em>, and the
<em>getFilePath()</em> has been renamed
+ <em>Part.getUploadName().</em>
+
+</p>
+</div>
+</div>
+
+<a name="N101B3"></a><a name="Components+from+the+scratchpad"></a>
+<h3>Components from the scratchpad</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>Cocoon 2.0.x had some components in the scratchpad area that have now
moved into
+ the main trunk as blocks. With this move some things have changed.
+ </p>
+<a name="N101BB"></a><a name="Session%2C+Authentication+and+Portal"></a>
+<h4>Session, Authentication and Portal</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>The session framework (sunShine), the authentication framework (sunRise)
+ and the portal framework (sunSpot) are now blocks (session-fw,
authentication-fw
+ and portal-fw).
+ </p>
+<p>The <em>sunShine transformer</em> has been renamed to <em>session
transformer</em>.
+ All sitemap components starting with <em>sunrise-</em> have been
changed to
+ start now with <em>auth-</em>. The <em>sunrise-auth</em> action has
been
+ renamed to <em>auth-protect</em>.
+ </p>
+<p>
+ The transformer namespace has changed from
<em>http://cocoon.apache.org/sunshine/1.0</em>
+ to <em>http://apache.org/cocoon/session/1.0</em> and the context names
have changed
+ from <em>sunshine</em> to <em>session</em> and from <em>sunrise</em> to
+ <em>authentication</em>.
+ </p>
+</div>
+</div>
+
+</div>
+</td><td width="10"><img width="10" height="1" alt=""
src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<!--================= end Content==================-->
+</table>
+</td>
+</tr>
+</table>
+<!--================= end Menu, NavBar, Content ==================-->
+<!--================= start Footer ==================-->
+<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
border="0">
+<tr>
+<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="../skin/images/spacer.gif" class="spacer"><a
href="../skin/images/label.gif"></a><a href="../skin/images/page.gif"></a><a
href="../skin/images/chapter.gif"></a><a
href="../skin/images/chapter_open.gif"></a><a
href="../skin/images/current.gif"></a><a href="..//favicon.ico"></a></td>
+</tr>
+<tr>
+<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
+ 1999-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
+ document.write(" - "+"Last Published: " +
document.lastModified);
+ // --></script></font></td>
+</tr>
+<tr>
+<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
+</tr>
+</table>
+<!--================= end Footer ==================-->
+</body>
+</html>
1.3 +425 -159 cocoon-site/site/2.1/installing/updating.pdf
<<Binary file>>
