home *** CD-ROM | disk | FTP | other *** search
/ PC Professionell 2004 December / PCpro_2004_12.ISO / files / webserver / xampp / xampp-cocoon-addon-1.4.9-installer.exe / faq-configure-c2.xml < prev    next >
Encoding:
Extensible Markup Language  |  2004-07-12  |  4.4 KB  |  121 lines
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!--
  3.   Copyright 1999-2004 The Apache Software Foundation
  4.  
  5.   Licensed under the Apache License, Version 2.0 (the "License");
  6.   you may not use this file except in compliance with the License.
  7.   You may obtain a copy of the License at
  8.  
  9.       http://www.apache.org/licenses/LICENSE-2.0
  10.  
  11.   Unless required by applicable law or agreed to in writing, software
  12.   distributed under the License is distributed on an "AS IS" BASIS,
  13.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.   See the License for the specific language governing permissions and
  15.   limitations under the License.
  16. -->
  17. <!DOCTYPE faqs PUBLIC "-//APACHE//DTD FAQ V1.0//EN" "faq-v10.dtd">
  18.  
  19. <faqs title="Cocoon Configuration FAQs">
  20.  
  21. <faq>
  22.  <question>
  23.   How do I setup my own .roles file?
  24.  </question>
  25.  <answer>
  26.   <p>
  27.    In cocoon.xconf you can specify your my.roles file as follows:
  28.   </p>
  29.  
  30. <source><![CDATA[
  31.    ...
  32.    <cocoon version="2.0" user-roles="/WEB-INF/my.roles">
  33.    ...
  34. ]]></source>
  35.  
  36.   <p>
  37.    if you are using Tomcat 4. For other versions, skip the leading
  38.    slash of the URI.
  39.   </p>
  40.  
  41.   <p>
  42.    And create a new file my.roles in WEB-INF directory with
  43.   </p>
  44.  
  45.   <source><![CDATA[
  46. <?xml version="1.0"?>
  47. <role-list>
  48.   <role name="org.apache.cocoon.components.jsp.JSPEngine"
  49.         shorthand="jsp-engine"
  50.         default-class="org.apache.cocoon.components.jsp.JSPEngineImplWLS"/>   
  51. </role-list>
  52. ]]></source>
  53.  
  54.  </answer>
  55. </faq>
  56.  
  57. <faq>
  58.   <question>
  59.   Where do I setup LogKit in Cocoon?
  60.   </question>
  61.   <answer>
  62.   <p>1. <code>{cocoon}/WEB-INF/logkit.xconf</code>:</p>
  63.    <p>Please refer to the
  64.     <link href="http://avalon.apache.org/logkit/index.html">Avalon LogKit Documentation</link></p>
  65.   <p>2. <code>{cocoon}/WEB-INF/web.xml</code>:</p>
  66.     <p>Here you can change following paramters:</p>
  67.     <ul>
  68.       <li><code>logkit-config</code>: This parameter indicates the configuration 
  69.       file of the LogKit management</li>
  70.       <li><code>servlet-logger</code>: This parameter indicates the category id 
  71.       of the logger from the LogKit configuration used by the CocoonServlet.</li>
  72.       <li><code>cocoon-logger</code>: This parameter indicates the category id of the 
  73.       logger from the LogKit management configuration for the Cocoon engine.
  74.       This logger is used for all components described in the cocoon.xconf 
  75.       and sitemap.xmap file not having specified a logger with the 
  76.       logger="..." attribute in the component configuration file.</li>
  77.       <li><code>log-level</code>: This parameter indicates the log level to use 
  78.       throughout startup of the system. As soon as the logkit.xconf the setting 
  79.       of the logkit.xconf configuration is used instead! Only for startup and if 
  80.       the logkit.xconf is not readable/available this log level is of
  81.       importance.</li>
  82.     </ul>
  83.     <note>See inline comments in these files for further information!</note>
  84.   <p>
  85. Learn more about LogKit configuration by downloading the free chapter, <link href="http://www.newriders.com/books/product.asp?product_id={C3C05052-BE3B-4E06-A60A-13FB40AF58F6}" >A User's Look at the Cocoon architecture,</link> from Langham and Ziegeler's <em>Cocoon: Building XML Applications</em> available at the New Riders web site.
  86.   </p>    
  87.   </answer>
  88. </faq>
  89.  
  90. <faq>
  91. <question>
  92. How can I change the physical location of my upload directory?
  93. </question>
  94. <answer>
  95.   <p>Look in web.xml file located in <your-webapp>/WEB-INF. There you will find the following snippet:</p>
  96.   <source><![CDATA[
  97.     <init-param>
  98.       <param-name>upload-directory</param-name>
  99.       <param-value>/WEB-INF/work/upload-dir</param-value>
  100.     </init-param>
  101. ]]></source>
  102.   <p>
  103. The above snippet shows the default path to the upload directory, specified within <param-value>. Replace it with a different path to your upload directory, relative to the context path of the servlet. 
  104.   </p>
  105. </answer>
  106. </faq>
  107.  
  108. <faq>
  109. <question>
  110. How can I solve 'Too many open files' errors when I try to create a search index for my site?
  111. </question>
  112. <answer>
  113.     <p>Either reduce the number of tags in your documant, by filtering it with xslt in your search view.</p>
  114.     <p>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.</p>
  115.     <p>example (Linux, bash shell): ulimit 2048</p>
  116.     <p>example (MacOSX, tcsh shell): limit descriptors 2048</p>
  117. </answer>
  118. </faq>
  119.  
  120. </faqs>
  121.