dims 01/06/04 03:47:07
Modified: xdocs installing.xml
Log:
Patch for JBoss install docs from
Sven Kuenzler ([EMAIL PROTECTED])
Revision Changes Path
1.6 +37 -1 xml-cocoon2/xdocs/installing.xml
Index: installing.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/xdocs/installing.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- installing.xml 2001/05/23 12:32:22 1.5
+++ installing.xml 2001/06/04 10:47:06 1.6
@@ -152,7 +152,7 @@
</li>
<li>
- <strong>Copy cocoon/lib/xerces-XXX.jar file to cocoon\lib</strong>
+ <strong>Copy cocoon/lib/xerces-XXX.jar file to tomcat\lib</strong>
Cocoon will now be able to see and use the correct XML libraries.
</li>
@@ -364,6 +364,42 @@
</li>
</ol>
</s2>
+ <s2 title="Installing on JBoss 2.2.2 with Tomcat 3.2.2">
+ <p>This section describes the deployment of the Cocoon 2 sample WAR with
+ the JBoss 2.2.2/Tomcat-3.2.2 package. It assumes that you built Cocoon 2 as
described above. All steps have been tested with a fresh JBoss 2.2.2 installation (the
package is available from <link href="http://sourceforge.net/projects/jboss/";>JBoss'
project page</link>)</p>
+ <p>When unpacking the JBoss/Tomcat package you get the following directory
+ structure</p>
+ <source>
+[path]/JBoss-2.2.2_Tomcat-3.2.2/jboss
+[path]/JBoss-2.2.2_Tomcat-3.2.2/tomcat
+ </source>
+ <p>Subsequently, <code>jboss</code> denotes the
<code>JBoss-2.2.2_Tomcat-3.2.2/jboss</code> directory and <code>cocoon</code> is the
base directory of your Cocoon 2 distribution or CVS checkout.</p>
+ <p>In order to get Cocoon 2 running you have to install Xerces as default XML
parser for JBoss.</p>
+ <ul><li>Stop the server if it is running.</li><li>Remove the following files
from the <code>jboss/lib</code>
directory<ul><li>jaxp.jar</li><li>parser.jar</li><li>xml.jar</li><li>crimson.jar</li></ul></li>
+ <li>Copy the <code>xerces-XXX.jar</code> and <code>xalan-XXX.jar</code> JAR
files from <code>cocoon/lib</code> to <code>jboss/lib</code></li>
+ <li>Change the <code>jboss/bin/run.sh</code></li>
+</ul>
+ <source>
+[...]
+# Add the XML parser jars and set the JAXP factory names
+# Crimson parser JAXP setup(default)
+# Change it to Xerces for C2
+JBOSS_CLASSPATH=$JBOSS_CLASSPATH:../lib/xerces-XXX.jar:../lib/xalan-XXX.jar
+# Comment out the following two lines as Xerces' JAXP implementation sets
+# these appropriately.
+#JAXP=-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.crimson.jaxp.DocumentBuilderFactoryImpl
+#JAXP="$JAXP
-Djavax.xml.parsers.SAXParserFactory=org.apache.crimson.jaxp.SAXParserFactoryImpl"
+[...]
+</source>
+<note>Windows users have to change <code>run.bat</code> accordingly.</note>
+ <ul><li>Start JBoss with <code>run_with_tomcat.sh</code> or
<code>run_with_tomcat.bat</code></li>
+ <li>Copy <code>cocoon/build/cocoon/cocoon.war</code> to
<code>jboss/deploy</code></li>
+ <li>Open the Cocoon welcome page (http://localhost:8080/cocoon/)</li>
+ <li>
+ Congratulations! (hopefully) you should see the Cocoon welcome page.
+ </li></ul>
+ <note>As both JBoss and Cocoon 2 ship with a Hypersonic database installed,
these both conflict and you won't be able to view the Cocoon database (SQL) samples.
Then again, you probably use JBoss for EJB persistence anyway, so this shouldn't
bother you to much ;-)</note>
+ </s2>
</s1>
</body>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
