You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by as...@apache.org on 2007/09/08 22:17:47 UTC
svn commit: r573901 [8/44] - in /cocoon/site: site/ site/2.0/
site/2.0/developing/ site/2.0/faq/ site/2.0/howto/chaperon/
site/2.0/installing/ site/2.0/plan/ site/2.0/snippet/ site/2.0/tutorial/
site/2.0/userdocs/ site/2.0/userdocs/actions/ site/2.0/us...
Modified: cocoon/site/site/2.0/faq/faq-configure-environment.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/faq/faq-configure-environment.html?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/faq/faq-configure-environment.html (original)
+++ cocoon/site/site/2.0/faq/faq-configure-environment.html Sat Sep 8 13:17:41 2007
@@ -1,837 +1,837 @@
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Environment Configuration FAQs</title>
-<STYLE type="text/css">
-a.menu {
- color: #FFFFFF;
- text-align:left;
- font-size:12px;
- font-family: Verdana, Arial, Helvetica, sans-serif;
- font-weight:plain;
- text-decoration:none;
- padding-left: 14px
-}
-
-A.menu:hover {
- color: #FFCC00
-}
-
-
-.menutitle {
- color: #000000;
- text-align:left;
- font-size:10px;
- font-family: Verdana, Arial, Helvetica, sans-serif;
- font-weight:bold;
- padding-left: 8px
-}
-.menuselected {
- color: #FFCC00;
- text-align:left;
- font-size:12px;
- font-family: Verdana, Arial, Helvetica, sans-serif;
- font-weight:bold;
- padding-left: 14px
-}
-</STYLE>
-</head>
-<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
-<table border="0" cellpadding="0" cellspacing="0" width="100%">
-<tr>
-<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
-</tr>
-<tr>
-<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Environment Configuration FAQs</font></td>
-</tr>
-<tr>
-<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
-<table width="288" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr width="100%">
-<td align="left" valign="top" width="120">
-<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
-<tr>
-<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">Main</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">FAQs</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="index.html">Index</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Getting Started</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-install.html">Install</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Configure</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-cvs.html">CVS</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Using</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-c2.html">Configure C2</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-databases.html">Databases</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xsp.html">XSP</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xslt.html">XSLT</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-debugging.html">Debugging</a></td>
-</tr>
-<tr>
-<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
-<span class="menutitle">Sitemap</span></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-sitemap.html">Sitemap</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-generators.html">Generators</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-transformers.html">Transformers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-serializers.html">Serializers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-matchers.html">Matchers</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-selectors.html">Selectors</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-actions.html">Actions</a></td>
-</tr>
-<tr>
-<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-aggregators.html">Aggregators</a></td>
-</tr>
-<tr>
-<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
-</td>
-</tr>
-</table>
-</td><td>
-<table cellspacing="15" cellpadding="0" border="0">
-<tr>
-<td><font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Questions</font>
-<hr style="color: #0086b2" size="1">
-<blockquote>
-<ul>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-1">How can I reach my Cocoon app from an URI other than
- <your-server>/cocoon/<my-app>?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-2">How could I have my Cocoon app located in a directory other than
- $TOMCAT_HOME/webapps/cocoon/<my-app>?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-3">
- How do I integrate Apache Server and Cocoon?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-4">
- How can I improve performance by making the web-server deliver the static contents ?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-5">
- How can I run Cocoon without X11. Why is a Display needed ?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-6">
- How can I access Cocoon's status page in a mixed servlet environment
- where "/" is not mapped to Cocoon (only *.xml, *.xsp)?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-7">
- How can I add my FAQ to this document?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-8">
- How can I suggest improvements to existing FAQs?
- </a></font>
-</li>
-</ul>
-</blockquote>
-<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Answers</font>
-<hr style="color: #0086b2" size="1">
-<a name="faq-1">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How can I reach my Cocoon app from an URI other than
- <your-server>/cocoon/<my-app>?
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Suppose the following.
- </font>
-</p>
-
-<blockquote>
-<ol>
-
-<li>
-<font face="verdana, helvetica, sans serif">You have a Cocoon application named "bar" which works fine when
- called with this URI: http://www.foo.com/cocoon/bar/index.html
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">You want the "bar" app to be called from
- http://www.foo.com/bar/index.html instead (getting rid of "cocoon").
- </font>
-</li>
-
-</ol>
-</blockquote>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- There are, basically, two methods to achieve this.
- </font>
-</p>
-
-<blockquote>
-<ol>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Set Cocoon as the root servlet in your servlet-container
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">Rewrite the URI in the web-server. (When a user asks for
- http://www.foo.com/bar/index.html, the web-server redirects him/her to
- http://www.foo.com/cocoon/bar/index.html
- </font>
-</li>
-
-</ol>
-</blockquote>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Let us explore the first method (Cocoon as the root servlet).
- </font>
-</p>
-
-<p>
-<table border="0" cellpadding="0" cellspacing="3" width="100%">
-<tr>
-<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
- This entry was tested under: Windows 2000
- Professional + IIS 5.0 + Tomcat 4.0.1 + Cocoon 2.0.2.
- </i></font></td>
-</tr>
-</table>
-</p>
-
-<blockquote>
-<ol>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Edit the server.xml file which is located under $TOMCAT_HOME/conf
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Go to the line containing "Tomcat Root Context". (This should be a comment).
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Add following line after that comment:
- <code><font face="courier, monospaced">
- <context path="" docBase="/cocoon" debug="0"/>
- </font></code>
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Re-start Tomcat.
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Try: http://www.foo.com:8080/ and the Cocoon welcome page should appear
- </font>
-</li>
-
-</ol>
-</blockquote>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Now, http://www.foo.com/bar/index.html should also work.
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Let us explore the second method (URI rewriting).
- </font>
-</p>
-
-<p>
-<table border="0" cellpadding="0" cellspacing="3" width="100%">
-<tr>
-<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i> This entry was tested under: Windows NT 4.0 + Apache 1.3.14 + Tomcat 3.2 +
- Cocoon 2.0b1. It is Apache-specific.
- </i></font></td>
-</tr>
-</table>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- The idea is just to redirect a portion of the desired URI (bar) to the one within
- the cocoon context (cocoon/bar).
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Apache has an handy feature called mod_rewrite that does just this: URI
- rewriting. (See the "URL Rewriting Guide" in the Apache user's guide for
- details).
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- First of all, you should instruct Apache to load the mod_rewrite.
- Add (on a Windows system) to httpd.conf the following line:
- </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
- LoadModule rewrite_module modules/ApacheModuleRewrite.dll
- </pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- (By the way it's quite likely that this line is already on the httpd.conf. You
- just have to uncomment it).
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Add this line to httpd.conf in order to activate mod_rewrite:
- </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
- RewriteEngine On
- </pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- It is highly recommended to use the logging option of mod_rewrite, in
- order to check the correctness of the URI rewriting. Just add these lines
- to the httpd.conf:
- </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
- RewriteLog "C:/logs/rewrite.log"
- RewriteLogLevel 9
- </pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- The first line tells Apache to put the URI rewriting log in the
- c:\logs\rewrite.log file (which happens to be on a Windows system, of
- course). The second one tells Apache to record everything mod_rewrite
- does. If you don't want to log anything, just set RewriteLogLevel to
- 0.
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Now, it's time to do the URI rewriting trick.
- </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
- RewriteRule bar/(.*) /cocoon/bar/$1 [PT]
- </pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- This line instructs Apache to redirect everything under "bar" to
- "cocoon/bar" and to pass it on for other processing ("[PT]" option),
- like mod_alias.
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Just restart Apache and point your browser to:
- </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
- <your-server>:8080/bar/<something>
- </pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- It should work just fine.
- </font>
-</p>
-
-<p>
-<table border="0" cellpadding="0" cellspacing="3" width="100%">
-<tr>
-<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
- The RewriteRule may not work in all cases (notably under Slackware Linux with Apache 1.3),
- if so, try replacing it with:
- RewriteRule ^/Foo /cocoon/Foo/ [R]
- RewriteRule ^/Foo(.*) /cocoon/Foo$1 [R]
- </i></font></td>
-</tr>
-</table>
-</p>
-
-<p>
-<table border="0" cellpadding="0" cellspacing="3" width="100%">
-<tr>
-<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
-Another user adds: In my experience, session support is lost when you use mod_rewrite because the cookie path for the Cocoon session is "/cocoon". Because the browser sees the path differently, the session cookie is not granted access, and sessions don't work. I got around this by renaming Cocoon to ROOT, I imagine setting the default docBase would have the same effect.
- </i></font></td>
-</tr>
-</table>
-</p>
-
-
-<a name="faq-2">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How could I have my Cocoon app located in a directory other than
- $TOMCAT_HOME/webapps/cocoon/<my-app>?
- </b></font>
-
-
-
-<p>
-<table border="0" cellpadding="0" cellspacing="3" width="100%">
-<tr>
-<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
- This entry was tested under Windows NT 4.0 + Apache 1.3.14 + Tomcat 3.2 + Cocoon
- 2.0b1.
- </i></font></td>
-</tr>
-</table>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Let's suppose the following.</font>
-</p>
-
-<blockquote>
-<ol>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- You have an application called "foo" which works perfectly when
- located under the %TOMCAT_HOME%\webapps\cocoon\foo directory.
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- You want it to be located under the "c:\foo" directory instead
- </font>
-</li>
-
-</ol>
-</blockquote>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- This could be accomplished quite easily by twisting the sitemap a little bit. The
- idea is to mount the sub-sitemap of the "foo" application in a specific
- location of the file system instead of under the default cocoon context.
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Here's the sitemap.xmap fragment used to do this.
- </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-
-<map:pipeline>
- <map:match pattern="foo/**">
- <map:mount uri-prefix="foo" src="file:///c:/foo/"/>
- </map:match>
-</map:pipeline>
-
- </pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- The "file:" type of source instructs Cocoon to search the sub-sitemap
- under the specified directory (which happens to be "c:\foo", since this
- is a Windows system). See explanation of
- <a href="../userdocs/concepts/sitemap.html#file-url">file: URLs</a>
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Now, you just need to copy everything which was under the
- %TOMCAT_HOME%\webapps\cocoon\foo directory to the c:\foo directory, and it should work
- graciously.
- </font>
-</p>
-
-
-<a name="faq-3">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- How do I integrate Apache Server and Cocoon?
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- See the Wiki page
- <a href="http://wiki.cocoondev.org/Wiki.jsp?page=ApacheModProxy">ApacheModProxy</a>
- for a thorough discussion of this topic.
- </font>
-</p>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Another method is to use mod_jk. Add the following line to
- <code><font face="courier, monospaced">%APACHE_HOME%\conf\httpd.conf</font></code>
- </font>
-</p>
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
- JkMount /cocoon/* ajp12
- </pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- along with other directives that are already listed in mod_jk.conf-auto
- in the tomcat/conf directory. The above directives can be added at the
- end of httpd.conf.
- </font>
-</p>
-
-
-<a name="faq-4">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- How can I improve performance by making the web-server deliver the static contents ?
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Fairly easy to do.
- </font>
-</p>
-
-<blockquote>
-<ol>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Put the static contents in a physical directory. (Let's call it "c:\foo\static-stuff".
- On UNIX it may be "/foo/static-stuff".)
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Make a virtual directory out of "c:\foo\static-stuff" (or, under UNIX "/foo/static-stuff")
- in you favorite web-server, and name it "static-foo".
- </font>
-</li>
-
-<li>
-<font face="verdana, helvetica, sans serif">
- Reference the static contents in your Cocoon app by URIs starting with "/static-foo", as in:
- "/static-foo/images/foo.gif" or "/static-foo/scripts/bar.js"
- </font>
-</li>
-
-</ol>
-</blockquote>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- The web-server will now handle the static contents, leaving Cocoon to take care of the
- dynamic stuff only, delivering optimal performance.
- </font>
-</p>
-
-
-<a name="faq-5">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- How can I run Cocoon without X11. Why is a Display needed ?
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- An Xserver is needed because of the batik library fop uses. batik uses
- java's graphics code, which in turn requires the Xserver.
- If you don't have an xserver on your system and can't set the DISPLAY
- variable to one, then try out xvfb. xvfb gives you an 'in-memory'
- xserver, which doesn't require any display hardware to run.
- </font>
-</p>
-
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
-$> Xvfb :1 -screen 0 800x600x8 &
-$> export DISPLAY=:1
-$> $TOMCAT_HOME/bin/startup.sh -f server.xml
-
- </pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Another solution is to use PJA library. Read 'Linux/Headless/Batik'
- section in the <a href="../installing/index.html">Cocoon installation guide</a>.
- </font>
-</p>
-
-
-<a name="faq-6">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- How can I access Cocoon's status page in a mixed servlet environment
- where "/" is not mapped to Cocoon (only *.xml, *.xsp)?
- </b></font>
-
-
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Just change the status pipeline so it matches a request with a ".xml" extension:
- </font>
-</p>
-
-
-<div align="center">
-<table border="0" cellpadding="0" cellspacing="4">
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
-<pre>
- <map:match pattern="status.xml">
- <map:generate src="status" type="status"/>
- <map:transform src="welcome/status2html.xsl"/>
- <map:serialize/>
- </map:match>
-</pre>
-</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-<tr>
-<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
-</tr>
-</table>
-</div>
-
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Then you can access the status page with "status.xml".
- </font>
-</p>
-
-
-<a name="faq-7">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- How can I add my FAQ to this document?
- </b></font>
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
-</p>
-<a name="faq-8">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
- How can I suggest improvements to existing FAQs?
- </b></font>
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
- Given the rapid pace of change with Cocoon, many individual FAQs quickly become out-of-date and confusing to new users. If you have the relevant knowledge, please consider updating other FAQs on this page for technical errors. If you see a few typos, please consider fixing them too. Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
-</p>
-</td>
-</tr>
-</table>
-</td>
-</tr>
-</table>
-<table width="100%" cellspacing="0" cellpadding="0" border="0">
-<tr>
-<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
-</tr>
-<tr>
-<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright © 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
-</tr>
-</table>
-</body>
-</html>
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Environment Configuration FAQs</title>
+<STYLE type="text/css">
+a.menu {
+ color: #FFFFFF;
+ text-align:left;
+ font-size:12px;
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ font-weight:plain;
+ text-decoration:none;
+ padding-left: 14px
+}
+
+A.menu:hover {
+ color: #FFCC00
+}
+
+
+.menutitle {
+ color: #000000;
+ text-align:left;
+ font-size:10px;
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ font-weight:bold;
+ padding-left: 8px
+}
+.menuselected {
+ color: #FFCC00;
+ text-align:left;
+ font-size:12px;
+ font-family: Verdana, Arial, Helvetica, sans-serif;
+ font-weight:bold;
+ padding-left: 14px
+}
+</STYLE>
+</head>
+<body bgcolor="#ffffff" marginheight="4" marginwidth="4" leftmargin="4" topmargin="4" alink="#cc0000" vlink="#0086b2" link="#039acc" text="#000000">
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr>
+<td align="left" valign="top" rowspan="3" height="60" width="135"><img border="0" vspace="0" hspace="0" src="images/logo.gif" height="60" width="135"></td><td background="images/line.gif" rowspan="1" colSpan="2" align="left" valign="top" height="0" width="100%"></td><td align="left" valign="top" rowspan="3" height="60" width="29"><img border="0" vspace="0" hspace="0" src="images/right.gif" height="60" width="29"></td>
+</tr>
+<tr>
+<td bgcolor="#0086b2" colspan="2" align="right" valign="top" height="35" width="100%"><font color="#ffffff" face="Verdana, Arial, Helvetica, sans-serif" size="5">Environment Configuration FAQs</font></td>
+</tr>
+<tr>
+<td background="images/bottom.gif" colspan="2" width="100%" valign="top" height="20" bgcolor="#0086b2" align="right">
+<table width="288" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td align="left" valign="top" height="20" width="96"><a target="new" href="http://xml.apache.org/"><img border="0" vspace="0" hspace="0" name="xml" src="images/button-xml-lo.gif" height="20" width="96" alt="http://xml.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.apache.org/"><img border="0" vspace="0" hspace="0" name="asf" src="images/button-asf-lo.gif" height="20" width="96" alt="http://www.apache.org/"></a></td><td align="left" valign="top" height="20" width="96"><a target="new" href="http://www.w3.org/"><img border="0" vspace="0" hspace="0" name="w3c" src="images/button-w3c-lo.gif" height="20" width="96" alt="http://www.w3.org/"></a></td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr width="100%">
+<td align="left" valign="top" width="120">
+<table width="120" cellspacing="0" cellpadding="0" border="0" bgcolor="#a0a0a0">
+<tr>
+<td valign="top" align="left"><img width="120" vspace="0" src="images/join.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="../index.html">Main</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">FAQs</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="index.html">Index</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Getting Started</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-install.html">Install</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><span class="menuselected">Configure</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-cvs.html">CVS</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Using</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-configure-c2.html">Configure C2</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-databases.html">Databases</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xsp.html">XSP</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-xslt.html">XSLT</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-debugging.html">Debugging</a></td>
+</tr>
+<tr>
+<td background="images/label-background_b.gif" bgcolor="#959595" valign="top"><img width="120" height="6" src="images/separator.gif"><br>
+<span class="menutitle">Sitemap</span></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-sitemap.html">Sitemap</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-generators.html">Generators</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-transformers.html">Transformers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-serializers.html">Serializers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-matchers.html">Matchers</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-selectors.html">Selectors</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-actions.html">Actions</a></td>
+</tr>
+<tr>
+<td valign="top" bgcolor="#959595" background="images/label-background_a.gif"><a class="menu" href="faq-aggregators.html">Aggregators</a></td>
+</tr>
+<tr>
+<td align="left" valign="top"><img width="120" vspace="0" src="images/close.gif" hspace="0" height="14" border="0"><br>
+</td>
+</tr>
+</table>
+</td><td>
+<table cellspacing="15" cellpadding="0" border="0">
+<tr>
+<td><font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Questions</font>
+<hr style="color: #0086b2" size="1">
+<blockquote>
+<ul>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-1">How can I reach my Cocoon app from an URI other than
+ <your-server>/cocoon/<my-app>?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-2">How could I have my Cocoon app located in a directory other than
+ $TOMCAT_HOME/webapps/cocoon/<my-app>?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-3">
+ How do I integrate Apache Server and Cocoon?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-4">
+ How can I improve performance by making the web-server deliver the static contents ?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-5">
+ How can I run Cocoon without X11. Why is a Display needed ?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-6">
+ How can I access Cocoon's status page in a mixed servlet environment
+ where "/" is not mapped to Cocoon (only *.xml, *.xsp)?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-7">
+ How can I add my FAQ to this document?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-8">
+ How can I suggest improvements to existing FAQs?
+ </a></font>
+</li>
+</ul>
+</blockquote>
+<font face="verdana, helvetica, sans serif" size="+2" color="#0086b2">Answers</font>
+<hr style="color: #0086b2" size="1">
+<a name="faq-1">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How can I reach my Cocoon app from an URI other than
+ <your-server>/cocoon/<my-app>?
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Suppose the following.
+ </font>
+</p>
+
+<blockquote>
+<ol>
+
+<li>
+<font face="verdana, helvetica, sans serif">You have a Cocoon application named "bar" which works fine when
+ called with this URI: http://www.foo.com/cocoon/bar/index.html
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">You want the "bar" app to be called from
+ http://www.foo.com/bar/index.html instead (getting rid of "cocoon").
+ </font>
+</li>
+
+</ol>
+</blockquote>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ There are, basically, two methods to achieve this.
+ </font>
+</p>
+
+<blockquote>
+<ol>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Set Cocoon as the root servlet in your servlet-container
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">Rewrite the URI in the web-server. (When a user asks for
+ http://www.foo.com/bar/index.html, the web-server redirects him/her to
+ http://www.foo.com/cocoon/bar/index.html
+ </font>
+</li>
+
+</ol>
+</blockquote>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Let us explore the first method (Cocoon as the root servlet).
+ </font>
+</p>
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
+ This entry was tested under: Windows 2000
+ Professional + IIS 5.0 + Tomcat 4.0.1 + Cocoon 2.0.2.
+ </i></font></td>
+</tr>
+</table>
+</p>
+
+<blockquote>
+<ol>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Edit the server.xml file which is located under $TOMCAT_HOME/conf
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Go to the line containing "Tomcat Root Context". (This should be a comment).
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Add following line after that comment:
+ <code><font face="courier, monospaced">
+ <context path="" docBase="/cocoon" debug="0"/>
+ </font></code>
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Re-start Tomcat.
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Try: http://www.foo.com:8080/ and the Cocoon welcome page should appear
+ </font>
+</li>
+
+</ol>
+</blockquote>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Now, http://www.foo.com/bar/index.html should also work.
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Let us explore the second method (URI rewriting).
+ </font>
+</p>
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i> This entry was tested under: Windows NT 4.0 + Apache 1.3.14 + Tomcat 3.2 +
+ Cocoon 2.0b1. It is Apache-specific.
+ </i></font></td>
+</tr>
+</table>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ The idea is just to redirect a portion of the desired URI (bar) to the one within
+ the cocoon context (cocoon/bar).
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Apache has an handy feature called mod_rewrite that does just this: URI
+ rewriting. (See the "URL Rewriting Guide" in the Apache user's guide for
+ details).
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ First of all, you should instruct Apache to load the mod_rewrite.
+ Add (on a Windows system) to httpd.conf the following line:
+ </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+ LoadModule rewrite_module modules/ApacheModuleRewrite.dll
+ </pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ (By the way it's quite likely that this line is already on the httpd.conf. You
+ just have to uncomment it).
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Add this line to httpd.conf in order to activate mod_rewrite:
+ </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+ RewriteEngine On
+ </pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ It is highly recommended to use the logging option of mod_rewrite, in
+ order to check the correctness of the URI rewriting. Just add these lines
+ to the httpd.conf:
+ </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+ RewriteLog "C:/logs/rewrite.log"
+ RewriteLogLevel 9
+ </pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ The first line tells Apache to put the URI rewriting log in the
+ c:\logs\rewrite.log file (which happens to be on a Windows system, of
+ course). The second one tells Apache to record everything mod_rewrite
+ does. If you don't want to log anything, just set RewriteLogLevel to
+ 0.
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Now, it's time to do the URI rewriting trick.
+ </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+ RewriteRule bar/(.*) /cocoon/bar/$1 [PT]
+ </pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ This line instructs Apache to redirect everything under "bar" to
+ "cocoon/bar" and to pass it on for other processing ("[PT]" option),
+ like mod_alias.
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Just restart Apache and point your browser to:
+ </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+ <your-server>:8080/bar/<something>
+ </pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ It should work just fine.
+ </font>
+</p>
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
+ The RewriteRule may not work in all cases (notably under Slackware Linux with Apache 1.3),
+ if so, try replacing it with:
+ RewriteRule ^/Foo /cocoon/Foo/ [R]
+ RewriteRule ^/Foo(.*) /cocoon/Foo$1 [R]
+ </i></font></td>
+</tr>
+</table>
+</p>
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
+Another user adds: In my experience, session support is lost when you use mod_rewrite because the cookie path for the Cocoon session is "/cocoon". Because the browser sees the path differently, the session cookie is not granted access, and sessions don't work. I got around this by renaming Cocoon to ROOT, I imagine setting the default docBase would have the same effect.
+ </i></font></td>
+</tr>
+</table>
+</p>
+
+
+<a name="faq-2">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>How could I have my Cocoon app located in a directory other than
+ $TOMCAT_HOME/webapps/cocoon/<my-app>?
+ </b></font>
+
+
+
+<p>
+<table border="0" cellpadding="0" cellspacing="3" width="100%">
+<tr>
+<td valign="top" width="28"><img alt="Note" border="0" hspace="0" vspace="0" height="29" width="28" src="images/note.gif"></td><td valign="top"><font color="black" face="verdana,helvetica,sanserif" size="-1"><i>
+ This entry was tested under Windows NT 4.0 + Apache 1.3.14 + Tomcat 3.2 + Cocoon
+ 2.0b1.
+ </i></font></td>
+</tr>
+</table>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Let's suppose the following.</font>
+</p>
+
+<blockquote>
+<ol>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ You have an application called "foo" which works perfectly when
+ located under the %TOMCAT_HOME%\webapps\cocoon\foo directory.
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ You want it to be located under the "c:\foo" directory instead
+ </font>
+</li>
+
+</ol>
+</blockquote>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ This could be accomplished quite easily by twisting the sitemap a little bit. The
+ idea is to mount the sub-sitemap of the "foo" application in a specific
+ location of the file system instead of under the default cocoon context.
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Here's the sitemap.xmap fragment used to do this.
+ </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+
+<map:pipeline>
+ <map:match pattern="foo/**">
+ <map:mount uri-prefix="foo" src="file:///c:/foo/"/>
+ </map:match>
+</map:pipeline>
+
+ </pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ The "file:" type of source instructs Cocoon to search the sub-sitemap
+ under the specified directory (which happens to be "c:\foo", since this
+ is a Windows system). See explanation of
+ <a href="../userdocs/concepts/sitemap.html#file-url">file: URLs</a>
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Now, you just need to copy everything which was under the
+ %TOMCAT_HOME%\webapps\cocoon\foo directory to the c:\foo directory, and it should work
+ graciously.
+ </font>
+</p>
+
+
+<a name="faq-3">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ How do I integrate Apache Server and Cocoon?
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ See the Wiki page
+ <a href="http://wiki.cocoondev.org/Wiki.jsp?page=ApacheModProxy">ApacheModProxy</a>
+ for a thorough discussion of this topic.
+ </font>
+</p>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Another method is to use mod_jk. Add the following line to
+ <code><font face="courier, monospaced">%APACHE_HOME%\conf\httpd.conf</font></code>
+ </font>
+</p>
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+ JkMount /cocoon/* ajp12
+ </pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ along with other directives that are already listed in mod_jk.conf-auto
+ in the tomcat/conf directory. The above directives can be added at the
+ end of httpd.conf.
+ </font>
+</p>
+
+
+<a name="faq-4">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ How can I improve performance by making the web-server deliver the static contents ?
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Fairly easy to do.
+ </font>
+</p>
+
+<blockquote>
+<ol>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Put the static contents in a physical directory. (Let's call it "c:\foo\static-stuff".
+ On UNIX it may be "/foo/static-stuff".)
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Make a virtual directory out of "c:\foo\static-stuff" (or, under UNIX "/foo/static-stuff")
+ in you favorite web-server, and name it "static-foo".
+ </font>
+</li>
+
+<li>
+<font face="verdana, helvetica, sans serif">
+ Reference the static contents in your Cocoon app by URIs starting with "/static-foo", as in:
+ "/static-foo/images/foo.gif" or "/static-foo/scripts/bar.js"
+ </font>
+</li>
+
+</ol>
+</blockquote>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ The web-server will now handle the static contents, leaving Cocoon to take care of the
+ dynamic stuff only, delivering optimal performance.
+ </font>
+</p>
+
+
+<a name="faq-5">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ How can I run Cocoon without X11. Why is a Display needed ?
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ An Xserver is needed because of the batik library fop uses. batik uses
+ java's graphics code, which in turn requires the Xserver.
+ If you don't have an xserver on your system and can't set the DISPLAY
+ variable to one, then try out xvfb. xvfb gives you an 'in-memory'
+ xserver, which doesn't require any display hardware to run.
+ </font>
+</p>
+
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+$> Xvfb :1 -screen 0 800x600x8 &
+$> export DISPLAY=:1
+$> $TOMCAT_HOME/bin/startup.sh -f server.xml
+
+ </pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Another solution is to use PJA library. Read 'Linux/Headless/Batik'
+ section in the <a href="../installing/index.html">Cocoon installation guide</a>.
+ </font>
+</p>
+
+
+<a name="faq-6">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ How can I access Cocoon's status page in a mixed servlet environment
+ where "/" is not mapped to Cocoon (only *.xml, *.xsp)?
+ </b></font>
+
+
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Just change the status pipeline so it matches a request with a ".xml" extension:
+ </font>
+</p>
+
+
+<div align="center">
+<table border="0" cellpadding="0" cellspacing="4">
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td bgcolor="#ffffff">
+<pre>
+ <map:match pattern="status.xml">
+ <map:generate src="status" type="status"/>
+ <map:transform src="welcome/status2html.xsl"/>
+ <map:serialize/>
+ </map:match>
+</pre>
+</td><td width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+<tr>
+<td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td><td height="1" width="1" bgcolor="#0086b2"><img border="0" hspace="0" vspace="0" height="1" width="1" src="images/void.gif"></td>
+</tr>
+</table>
+</div>
+
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Then you can access the status page with "status.xml".
+ </font>
+</p>
+
+
+<a name="faq-7">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ How can I add my FAQ to this document?
+ </b></font>
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
+</p>
+<a name="faq-8">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+ How can I suggest improvements to existing FAQs?
+ </b></font>
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+ Given the rapid pace of change with Cocoon, many individual FAQs quickly become out-of-date and confusing to new users. If you have the relevant knowledge, please consider updating other FAQs on this page for technical errors. If you see a few typos, please consider fixing them too. Follow the instructions found in <a href="../howto/howto-author-faq.html">How-To Author an FAQ.</a></font>
+</p>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+<table width="100%" cellspacing="0" cellpadding="0" border="0">
+<tr>
+<td bgcolor="#0086b2"><img width="1" src="images/dot.gif" height="1"></td>
+</tr>
+<tr>
+<td align="center"><font size="-1" face="arial,helvetica,sanserif" color="#0086b2"><i>Copyright © 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
+</tr>
+</table>
+</body>
+</html>