User: tmcsys
Date: 01/09/11 12:18:19
Added: src/xdocs/howto howtococoon.xml
Log:
Document Cocoon 2 Deployment on JBoss-Tomcat
Revision Changes Path
1.1 manual/src/xdocs/howto/howtococoon.xml
Index: howtococoon.xml
===================================================================
<?xml version = "1.0" encoding = "UTF-8"?>
<!-- $Id: howtococoon.xml,v 1.1 2001/09/11 19:18:19 tmcsys Exp $ -->
<!--DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"docbookx/docbookx.dtd"-->
<section id="howtococoon">
<title>Deploying Cocoon 2 in JBoss</title>
<para>Author:<author>
<firstname>Tom</firstname>
<surname>Coleman</surname>
</author>
<email>[EMAIL PROTECTED]</email>
</para>
<section>
<title>Introduction</title>
<para>Apache Cocoon is a next-generation XML publishing framework.
According to the developers, Cocoon 2 is currently "beta quality".</para>
<para>Cocoon 2 is very easily deployed using JBoss 2.4 configured to
use Embedded Tomcat 3.2.2. The specific release used was JBoss 2.4 BETA
Rel_2_4_0_23.</para>
<para>The deployment was on a RH Linux 6.2 system using the Sun 1.3
jdk.</para></section>
<section>
<title>Outstanding Deployment Issues</title>
<formalpara>
<title>SQL examples</title>
<para>This documentation does not address getting the SQL examples to
work. If you have successfully deployed the Cocoon 2 SQL examples using JBoss, please
post your experiences to the jboss-user mailing list.</para>
</formalpara>
<formalpara>
<title>Cocoon 2 and JBoss-Jetty</title>
<para>If you have successfully deployed Cocoon 2 using JBoss-Jetty,
please post your experiences to the jboss-user mailing list.</para>
</formalpara>
<formalpara>
<title>X Server required</title>
<para>One of the advanced features of Cocoon 2 is support of Scalable
Vector Graphics. On Unix platforms, this feature requires access to an X server. If
your system does not run an X server and you have problems with the "sitemap", search
the <ulink url="http://xml.apache.org/cocoon2/mail-archives.html";>Cocoon Mailing List
Archives</ulink> for Xvfb.</para>
</formalpara>
</section>
<section>
<title>Contributors:</title>
<itemizedlist>
<listitem><para>David Rothman</para></listitem>
<listitem><para>Jan Heise</para></listitem>
<listitem><para>Tom Coleman</para></listitem>
</itemizedlist>
</section>
<section>
<title>Installation & Configuration</title>
<orderedlist>
<listitem>
<para>Download Cocoon 2</para>
<para>You can get the source from <ulink
url="http://xml.apache.org/cocoon2/dist";>The Apache Project's XML Download
Page</ulink>. We used the "Cocoon-2.0b2" package.</para>
</listitem>
<listitem>
<para>Build the Cocoon 2 WAR package</para>
<para>Follow the instructions in the <ulink
url="http://xml.apache.org/cocoon2/install.html";>Cocoon installation
instructions</ulink> to build the Apache Cocoon 2 WAR package. The resulting .war
file will be deployed in the $JBOSS_HOME/deploy directory.</para>
</listitem>
<listitem>
<para>Modify JBoss and Tomcat JARS and Classpath</para>
<para>The Cocoon installation instructions have a
section on installing on JBoss 2.2.2 with Tomcat 3.2.2. These instructions work for
JBoss 2.4.x. Remove the unneeded JAR files from the JBoss and Tomcat /lib
directories. If you are using JBoss 2.4.x, ignore the reference to xml.jar.</para>
<para>Add xerces_1_4_1.jar to $JBOSS_CLASSPATH and
comment out the JAXP references in $JBOSS_HOME/bin/run.sh.</para>
</listitem>
<listitem>
<para>Start JBoss</para>
<para>Start JBoss and copy the cocoon.war to the
deploy directory. You should see JBoss deploy Cocoon.</para>
</listitem>
<listitem>
<para>Run Cocoon</para>
<para>Point your browser to
http://your-server-name.your-domain:8080/cocoon to start Cocoon.</para>
</listitem>
</orderedlist>
</section>
</section>
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development
