You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cocoon.apache.org by bu...@apache.org on 2002/02/11 17:34:51 UTC
DO NOT REPLY [Bug 6370] New: -
[PATCH] Updated install documentation to include JBoss 2.4.4/Tomcat 4.0.1
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=6370>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND
INSERTED IN THE BUG DATABASE.
http://nagoya.apache.org/bugzilla/show_bug.cgi?id=6370
[PATCH] Updated install documentation to include JBoss 2.4.4/Tomcat 4.0.1
Summary: [PATCH] Updated install documentation to include JBoss
2.4.4/Tomcat 4.0.1
Product: Cocoon 2
Version: Current CVS
Platform: All
OS/Version: Windows NT/2K
Status: NEW
Severity: Enhancement
Priority: Other
Component: core
AssignedTo: cocoon-dev@xml.apache.org
ReportedBy: jls.apache@doppke.com
I updated the installer doc
(cocoon2/src/documentation/xdocs/installing/index.xml) to include instructions
for the current versions of JBoss and Tomcat. JBoss changed its jar structure
so the old instructions didn't work. Instructions for prior version of JBoss
were left intact. Patch is based on rev 1.7 of
cocoon2/src/documentation/xdocs/installing/index.xml:
+++ index.xml Mon Feb 11 11:16:10 2002
@@ -484,6 +484,56 @@
</li>
</ol>
</s2>
+ <s2 title="Installing on JBoss 2.4.4 with Tomcat 4.0.1 (Catalina)">
+ <p>This section describes the deployment of the Cocoon sample WAR with
+ the JBoss-2.4.4_Tomcat-4.0.1 package. It assumes that you built Cocoon
as described above or downloaded the binary Cocoon distribution. All steps have
been tested with a fresh JBoss 2.4.4 installation on Linux and Windows 2000.</p
>
+ <note>The JBoss/Tomcat bundle is available from the <link href="http://s
ourceforge.net/projects/jboss/">JBoss project page</link></note>
+ <p>The JBoss/Tomcat package has the following directory
+ structure</p>
+ <source>
+ [path]/JBoss-2.4.4_Tomcat-4.0.1/jboss
+ [path]/JBoss-2.4.4_Tomcat-4.0.1/catalina
+ </source>
+ <p>Subsequently, </p>
+ <ul><li><code>jboss</code> denotes the <code>JBoss-2.4.4_Tomc
at-4.0.1/jboss</code> directory</li>
+ <li><code>catalina</code> is short for <code>JBoss-2.4.4_Tomcat
-4.0.1/catalina</code></li><li>and <code>cocoon</code> is the base directory of
your Cocoon distribution or CVS checkout.</li></ul>
+ <p>In order to get Cocoon running you have to install Xerces as d
efault XML parser for JBoss.</p>
+ <ul>
+ <li>Stop JBoss if it is running.</li>
+ <li>Remove the following files from the <code>jboss/lib</code>
directory
+ <ul>
+ <li>crimson.jar</li>
+ <li>jaxp.jar</li>
+ </ul>
+ </li>
+ <li>Copy <code>xml-apis.jar</code> from <code>cocoon/lib</code>
to <code>jboss/lib</code></li>
+ <li>Change <code>jboss/bin/run.sh</code></li>
+ </ul>
+ <source>
+ [...]
+ # Add the XML parser jar and set the JAXP factory names
+ # Crimson parser JAXP setup(default)
+ <strong># Change it to Xerces for C2</strong>
+ JBOSS_CLASSPATH=$JBOSS_CLASSPATH:<strong>../lib/xml-apis.jar</strong>
+ <strong># Remove the following two lines</strong>
+ <sub>JAXP=-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.crimso
n.jaxp.DocumentBuilderFactoryImpl
+ JAXP="$JAXP -Djavax.xml.parsers.SAXParserFactory=org.apache.crimson.ja
xp.SAXParserFactoryImpl"</sub>
+ [...]
+ </source>
+ <note>Windows users have to change <code>run.bat</code> according
ly.
+ </note>
+ <ul>
+ <li>Start JBoss with <code>run_with_catalina.sh</code> or <code
>run_with_catalina.bat</code></li>
+ <li>Copy <code>cocoon/build/cocoon/cocoon.war</code> to <code>j
boss/deploy</code></li>
+ <li>Check the server log to make sure that <code>J2EE applicati
on: [...]/cocoon.war is deployed.</code></li>
+ <li>Open the Cocoon welcome page (http://localhost:8080/cocoon/
)</li>
+ <li>
+ You should see the Cocoon welcome page.
+ </li>
+ </ul>
+ <note>As both JBoss and Cocoon ship with a Hypersonic database in
stalled, these two conflict and you won't be able to use Cocoon database (SQL) s
amples. Then again, you probably use JBoss for EJB persistence anyway, so this s
houldn't bother you too much ;-)
+ </note>
+ </s2>
<s2 title="Installing on JBoss 2.2.2 with Tomcat 3.2.2">
<p>This section describes the deployment of the Cocoon sample WAR with
the JBoss 2.2.2/Tomcat-3.2.2 package. It assumes that you built Cocoon as
described above. All steps have been tested with a fresh JBoss 2.2.2 installatio
n on Linux and Windows ME(sic).</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org