You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@cocoon.apache.org by bl...@apache.org on 2001/04/05 16:22:21 UTC
cvs commit: xml-cocoon/xdocs faq.xml site-book.xml
bloritsch 01/04/05 07:22:21
Modified: xdocs Tag: xml-cocoon2 faq.xml site-book.xml
Log:
Updated FAQ with entries in INSTALL, and updated the "site-book.xml" file
Revision Changes Path
No revision
No revision
1.6.2.4 +118 -16 xml-cocoon/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-cocoon/xdocs/faq.xml,v
retrieving revision 1.6.2.3
retrieving revision 1.6.2.4
diff -u -r1.6.2.3 -r1.6.2.4
--- faq.xml 2001/01/15 15:20:53 1.6.2.3
+++ faq.xml 2001/04/05 14:22:20 1.6.2.4
@@ -3,8 +3,125 @@
<!DOCTYPE faqs SYSTEM "./dtd/faq-v10.dtd">
<faqs title="Frequently Asked Questions">
-
<faq>
+ <question>
+ Why does nothing happen when I access 'http://localhost/cocoon/'?
+ </question>
+ <answer>
+ <p>
+ You might want to check a few things:
+ </p>
+ <ul>
+ <li>
+ is your server listening to port 80? if not, you have to call the right
+ port like in 'http://localhost:8080/cocoon/'. Note that Apache Tomcat
+ binds by default to port 8080, NOT 80.
+ </li>
+ <li>
+ did your servlet engine install the WAR file? you can check by making
+ sure the WAR file was unpacked or connecting to the administration tools
+ of your servlet engine.
+ </li>
+ <li>
+ did you restart the servlet engine? if not, do it.
+ </li>
+ </ul>
+ </answer>
+</faq>
+<faq>
+ <question>
+ Why does Cocoon take so long to start?
+ </question>
+ <answer>
+ <p>
+ Cocoon compiles sitemaps into java classes to increase runtime performance,
+ this is done only at startup and only if the sitemap file is modified, for
+ all the other requests the compiled sitemap is executed. See question #7
+ for information on how to pre-compile the sitemap and the XSP's.
+ </p>
+ </answer>
+</faq>
+<faq>
+ <question>
+ Why is cocoon.war so big?
+ </question>
+ <answer>
+ <p>
+ Cocoon.war includes all the libraries that it requires to run. They are
+ several megabytes of Java classes and it also includes the JDK javac compiler
+ which must be present in the war file to allow page compilation without
+ classloading problems.
+ </p>
+ </answer>
+</faq>
+<faq>
+ <question>
+ I get a java.lang.VerifyError when accessing 'http://localhost/cocoon/'.
+ What's wrong?
+ </question>
+ <answer>
+ <p>
+ Cocoon requires a JAXP 1.1 compliant parser. Recent servlet engines
+ (like Tomcat 3.2.1) use older xml parsers. You have to replace the xml
+ parser with a newer one (e.g. the Xerces 1.3.0).
+ </p>
+ <p>
+ For Tomcat 3.2.1 simply remove the jaxp.jar and the parser.jar from the
+ tomcat/lib directory and copy the xerces.jar to this directory and rename
+ it to parser.jar. Before you restart Tomcat make sure to remove the
+ tomcat/work directory beforehand.
+ </p>
+ </answer>
+</faq>
+<faq>
+ <question>
+ I'm still stuck, what do I do?
+ </question>
+ <answer>
+ <p>
+ Contact the Cocoon Users mail list (cocoon-users@xml.apache.org).
+ Please, do not contact developers directly for help since the user list are
+ normally much more responsive and users normally have more experience in
+ solving installation problems than developers do.
+ </p>
+ <p>
+ Cocoon has a log file that is stored in the context where you placed
+ Cocoon. It is located in '{cocoon}/WEB-INF/logs/cocoon/log' where
+ {cocoon} is the context where Cocoon is installed. Many times, the
+ information contained in that file will help others help you.
+ </p>
+ </answer>
+</faq>
+<faq>
+ <question>
+ What are the steps to pre-compile the sitemap and XSP's?
+ </question>
+ <answer>
+ <ol>
+ <li>Set the "work-directory" parameter in web.xml as follows:
+<code>
+ <![CDATA[
+ <init-param>
+ <param-name>work-directory</param-name>
+ <param-value>WEB-INF/classes</param-value>
+ </init-param>
+ ]]>
+</code>
+ </li>
+ <li>Set the auto-reload to false in your sitemap.xmap as follows:
+<code>
+ <![CDATA[
+ <parameter name="auto-reload" value="false"/>
+ ]]>
+</code>
+ </li>
+ <li>Use "-Dcompile.xsp=yes" in your build command line when you are
+ building your WAR file.
+ </li>
+ </ol>
+ </answer>
+</faq>
+<faq>
<question>
Cocoon won't start and I get a "java.lang.NoSuchMethodError: org.apache.log.LogKit: method
createLogger(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)Lorg/apache/log/Logger;
@@ -35,19 +152,4 @@
</p>
</answer>
</faq>
-<faq>
- <question>
- I have a J2EE server and I want to use the J2eeDataSource that the docs said was available.
- When I try to use it, I get a ClassNotFoundException.
- </question>
- <answer>
- <p>
- When you build Cocoon, you need the package that has JNDI and the JDBC Extensions in
- the classpath. The build script automatically determines if they exist. You can place
- a copy directly in the "lib" directory and rebuild Cocoon. The missing class
- should now be there.
- </p>
- </answer>
-</faq>
-
</faqs>
1.4.2.8 +4 -0 xml-cocoon/xdocs/site-book.xml
Index: site-book.xml
===================================================================
RCS file: /home/cvs/xml-cocoon/xdocs/site-book.xml,v
retrieving revision 1.4.2.7
retrieving revision 1.4.2.8
diff -u -r1.4.2.7 -r1.4.2.8
--- site-book.xml 2001/02/21 14:30:40 1.4.2.7
+++ site-book.xml 2001/04/05 14:22:21 1.4.2.8
@@ -9,10 +9,14 @@
<page id="index" label="Index" source="index.xml"/>
<page id="license" label="License" source="license.xml"/>
<page id="install" label="Install" source="installing.xml"/>
+<separator/>
+ <page id="xsp" label="XSP" source="xsp.xml"/>
<page id="xsp-internals" label="XSP Internals" source="xsp-internals.xml"/>
<page id="logicsheet-concepts" label="XSP Logicsheets" source="logicsheet-concepts.xml"/>
<page id="sessions" label="Sessions" source="sessions.xml"/>
+<separator/>
<page id="actions" label="Actions" source="actions.xml"/>
+ <page id="datasources" label="Using Databases" source="datasources.xml"/>
<page id="sitemap" label="Sitemap" source="sitemap.xml"/>
<page id="svg" label="SVG Serializer" source="svg-serializer.xml"/>
<separator/>
----------------------------------------------------------------------
In case of troubles, e-mail: webmaster@xml.apache.org
To unsubscribe, e-mail: cocoon-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: cocoon-cvs-help@xml.apache.org