cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 6370] New: - [PATCH] Updated install documentation to include JBoss 2.4.4/Tomcat 4.0.1
Date Mon, 11 Feb 2002 16:34:51 GMT
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


Mime
View raw message