cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From asav...@apache.org
Subject svn commit: r573901 [7/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...
Date Sat, 08 Sep 2007 20:17:47 GMT
Modified: cocoon/site/site/2.0/faq/faq-configure-c2.html
URL: http://svn.apache.org/viewvc/cocoon/site/site/2.0/faq/faq-configure-c2.html?rev=573901&r1=573900&r2=573901&view=diff
==============================================================================
--- cocoon/site/site/2.0/faq/faq-configure-c2.html (original)
+++ cocoon/site/site/2.0/faq/faq-configure-c2.html Sat Sep  8 13:17:41 2007
@@ -1,421 +1,421 @@
-<html>
-<head>
-<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-<title>Cocoon 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">Cocoon 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"><a
class="menu" href="faq-configure-environment.html">Configure</a></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"><span
class="menuselected">Configure C2</span></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 do I setup my own .roles file?
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-2">
-  Where do I setup LogKit in Cocoon?
-  </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-3">
-How can I change the physical location of my upload directory?
-</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-4">
-How can I solve 'Too many open files' errors when I try to create a search index for my site?
-</a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-5">
-  How can I add my FAQ to this document? 
- </a></font>
-</li>
-<li>
-<font face="verdana, helvetica, sans serif"><a href="#faq-6">
-  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 do I setup my own .roles file?
- </b></font>
- 
- 
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-   In cocoon.xconf you can specify your my.roles file as follows:
-  </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>
-   ...
-   &lt;cocoon version="2.0" user-roles="/WEB-INF/my.roles"&gt;
-   ...
-</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">
-   if you are using Tomcat 4. For other versions, skip the leading
-   slash of the URI.
-  </font>
-</p>
-
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-   And create a new file my.roles in WEB-INF directory with
-  </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>
-&lt;?xml version="1.0"?&gt;
-&lt;role-list&gt;
-  &lt;role name="org.apache.cocoon.components.jsp.JSPEngine"
-        shorthand="jsp-engine"
-        default-class="org.apache.cocoon.components.jsp.JSPEngineImplWLS"/&gt;   
-&lt;/role-list&gt;
-</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>
-
- 
-
-<a name="faq-2">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-  Where do I setup LogKit in Cocoon?
-  </b></font>
-  
-  
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">1. <code><font face="courier,
monospaced">{cocoon}/WEB-INF/logkit.xconf</font></code>:</font>
-</p>
-   
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Please refer to the
-    <a href="http://avalon.apache.org/logkit/index.html">Avalon LogKit Documentation</a></font>
-</p>
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">2. <code><font face="courier,
monospaced">{cocoon}/WEB-INF/web.xml</font></code>:</font>
-</p>
-    
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Here you can change following
paramters:</font>
-</p>
-    
-<blockquote>
-<ul>
-      
-<li>
-<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">logkit-config</font></code>:
This parameter indicates the configuration 
-      file of the LogKit management</font>
-</li>
-      
-<li>
-<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">servlet-logger</font></code>:
This parameter indicates the category id 
-      of the logger from the LogKit configuration used by the CocoonServlet.</font>
-</li>
-      
-<li>
-<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">cocoon-logger</font></code>:
This parameter indicates the category id of the 
-      logger from the LogKit management configuration for the Cocoon engine.
-      This logger is used for all components described in the cocoon.xconf 
-      and sitemap.xmap file not having specified a logger with the 
-      logger="..." attribute in the component configuration file.</font>
-</li>
-      
-<li>
-<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">log-level</font></code>:
This parameter indicates the log level to use 
-      throughout startup of the system. As soon as the logkit.xconf the setting 
-      of the logkit.xconf configuration is used instead! Only for startup and if 
-      the logkit.xconf is not readable/available this log level is of
-      importance.</font>
-</li>
-    
-</ul>
-</blockquote>
-    
-<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>See inline comments in these files
for further information!</i></font></td>
-</tr>
-</table>
-</p>
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">
-Learn more about LogKit configuration by downloading the free chapter, <a href="http://www.newriders.com/books/product.asp?product_id={C3C05052-BE3B-4E06-A60A-13FB40AF58F6}">A
User's Look at the Cocoon architecture,</a> from Langham and Ziegeler's <i>Cocoon:
Building XML Applications</i> available at the New Riders web site.
-  </font>
-</p>    
-  
-
-<a name="faq-3">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-How can I change the physical location of my upload directory?
-</b></font>
-
-
-  
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Look in web.xml file located
in &lt;your-webapp&gt;/WEB-INF. There you will find the following snippet:</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>
-    &lt;init-param&gt;
-      &lt;param-name&gt;upload-directory&lt;/param-name&gt;
-      &lt;param-value&gt;/WEB-INF/work/upload-dir&lt;/param-value&gt;
-    &lt;/init-param&gt;
-</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 above snippet shows the default path to the upload directory, specified within &lt;param-value&gt;.
Replace it with a different path to your upload directory, relative to the context path of
the servlet. 
-  </font>
-</p>
-
-
-<a name="faq-4">
-<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
-How can I solve 'Too many open files' errors when I try to create a search index for my site?
-</b></font>
-
-
-	
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Either reduce the number of tags
in your documant, by filtering it with xslt in your search view.</font>
-</p>
-	
-<p>
-<font color="black" face="verdana,helvetica,sanserif">Or, increase the limit on the
number of files your opperating system allows you to have open simultaneously, in the shell
you launch the servlet engine in.</font>
-</p>
-	
-<p>
-<font color="black" face="verdana,helvetica,sanserif">example (Linux, bash shell):
ulimit 2048</font>
-</p>
-	
-<p>
-<font color="black" face="verdana,helvetica,sanserif">example (MacOSX, tcsh shell):
limit descriptors 2048</font>
-</p>
-
-
-<a name="faq-5">
-<!--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-6">
-<!--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
&copy; 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>Cocoon 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">Cocoon 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"><a
class="menu" href="faq-configure-environment.html">Configure</a></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"><span
class="menuselected">Configure C2</span></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 do I setup my own .roles file?
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-2">
+  Where do I setup LogKit in Cocoon?
+  </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-3">
+How can I change the physical location of my upload directory?
+</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-4">
+How can I solve 'Too many open files' errors when I try to create a search index for my site?
+</a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-5">
+  How can I add my FAQ to this document? 
+ </a></font>
+</li>
+<li>
+<font face="verdana, helvetica, sans serif"><a href="#faq-6">
+  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 do I setup my own .roles file?
+ </b></font>
+ 
+ 
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+   In cocoon.xconf you can specify your my.roles file as follows:
+  </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>
+   ...
+   &lt;cocoon version="2.0" user-roles="/WEB-INF/my.roles"&gt;
+   ...
+</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">
+   if you are using Tomcat 4. For other versions, skip the leading
+   slash of the URI.
+  </font>
+</p>
+
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+   And create a new file my.roles in WEB-INF directory with
+  </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>
+&lt;?xml version="1.0"?&gt;
+&lt;role-list&gt;
+  &lt;role name="org.apache.cocoon.components.jsp.JSPEngine"
+        shorthand="jsp-engine"
+        default-class="org.apache.cocoon.components.jsp.JSPEngineImplWLS"/&gt;   
+&lt;/role-list&gt;
+</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>
+
+ 
+
+<a name="faq-2">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+  Where do I setup LogKit in Cocoon?
+  </b></font>
+  
+  
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">1. <code><font face="courier,
monospaced">{cocoon}/WEB-INF/logkit.xconf</font></code>:</font>
+</p>
+   
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Please refer to the
+    <a href="http://avalon.apache.org/logkit/index.html">Avalon LogKit Documentation</a></font>
+</p>
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">2. <code><font face="courier,
monospaced">{cocoon}/WEB-INF/web.xml</font></code>:</font>
+</p>
+    
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Here you can change following
paramters:</font>
+</p>
+    
+<blockquote>
+<ul>
+      
+<li>
+<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">logkit-config</font></code>:
This parameter indicates the configuration 
+      file of the LogKit management</font>
+</li>
+      
+<li>
+<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">servlet-logger</font></code>:
This parameter indicates the category id 
+      of the logger from the LogKit configuration used by the CocoonServlet.</font>
+</li>
+      
+<li>
+<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">cocoon-logger</font></code>:
This parameter indicates the category id of the 
+      logger from the LogKit management configuration for the Cocoon engine.
+      This logger is used for all components described in the cocoon.xconf 
+      and sitemap.xmap file not having specified a logger with the 
+      logger="..." attribute in the component configuration file.</font>
+</li>
+      
+<li>
+<font face="verdana, helvetica, sans serif"><code><font face="courier, monospaced">log-level</font></code>:
This parameter indicates the log level to use 
+      throughout startup of the system. As soon as the logkit.xconf the setting 
+      of the logkit.xconf configuration is used instead! Only for startup and if 
+      the logkit.xconf is not readable/available this log level is of
+      importance.</font>
+</li>
+    
+</ul>
+</blockquote>
+    
+<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>See inline comments in these files
for further information!</i></font></td>
+</tr>
+</table>
+</p>
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">
+Learn more about LogKit configuration by downloading the free chapter, <a href="http://www.newriders.com/books/product.asp?product_id={C3C05052-BE3B-4E06-A60A-13FB40AF58F6}">A
User's Look at the Cocoon architecture,</a> from Langham and Ziegeler's <i>Cocoon:
Building XML Applications</i> available at the New Riders web site.
+  </font>
+</p>    
+  
+
+<a name="faq-3">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+How can I change the physical location of my upload directory?
+</b></font>
+
+
+  
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Look in web.xml file located
in &lt;your-webapp&gt;/WEB-INF. There you will find the following snippet:</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>
+    &lt;init-param&gt;
+      &lt;param-name&gt;upload-directory&lt;/param-name&gt;
+      &lt;param-value&gt;/WEB-INF/work/upload-dir&lt;/param-value&gt;
+    &lt;/init-param&gt;
+</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 above snippet shows the default path to the upload directory, specified within &lt;param-value&gt;.
Replace it with a different path to your upload directory, relative to the context path of
the servlet. 
+  </font>
+</p>
+
+
+<a name="faq-4">
+<!--anchor--></a><font face="verdana, helvetica, sans serif" size="+1" color="#0086b2"><b>
+How can I solve 'Too many open files' errors when I try to create a search index for my site?
+</b></font>
+
+
+	
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Either reduce the number of tags
in your documant, by filtering it with xslt in your search view.</font>
+</p>
+	
+<p>
+<font color="black" face="verdana,helvetica,sanserif">Or, increase the limit on the
number of files your opperating system allows you to have open simultaneously, in the shell
you launch the servlet engine in.</font>
+</p>
+	
+<p>
+<font color="black" face="verdana,helvetica,sanserif">example (Linux, bash shell):
ulimit 2048</font>
+</p>
+	
+<p>
+<font color="black" face="verdana,helvetica,sanserif">example (MacOSX, tcsh shell):
limit descriptors 2048</font>
+</p>
+
+
+<a name="faq-5">
+<!--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-6">
+<!--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
&copy; 1999-2002 The Apache Software Foundation. All Rights Reserved.</i></font></td>
+</tr>
+</table>
+</body>
+</html>



Mime
View raw message