svn commit: r765258 - in /tapestry/tapestry5/trunk/src/site: apt/glassfish.apt site.xml

[hl...@apache.org]

Author: hlship
Date: Wed Apr 15 16:14:19 2009
New Revision: 765258

URL: http://svn.apache.org/viewvc?rev=765258&view=rev
Log:
TAP5-642: Document how to configure Glassfish 2.1 to deploy Tapestry applications

Added:
    tapestry/tapestry5/trunk/src/site/apt/glassfish.apt   (with props)
Modified:
    tapestry/tapestry5/trunk/src/site/site.xml

Added: tapestry/tapestry5/trunk/src/site/apt/glassfish.apt
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/src/site/apt/glassfish.apt?rev=765258&view=auto
==============================================================================
--- tapestry/tapestry5/trunk/src/site/apt/glassfish.apt (added)
+++ tapestry/tapestry5/trunk/src/site/apt/glassfish.apt Wed Apr 15 16:14:19 2009
@@ -0,0 +1,40 @@
+ ----
+ Deployment Notes: Glassfish
+ ----
+
+Deployment Notes: Glassfish 2.1
+
+  Deploying Tapestry applications into Glassfish has one snag: a conflict in the
+  {{{http://en.wikipedia.org/wiki/StAX}StAX parser}} (used to parse component templates).
+  Tapestry must use the
+  {{{http://woodstox.codehaus.org/}Woodstox StAX parser}}, and Glassfish provides an alternate parser.
+
+  Fortunately, you can override Glassfish, and force it to use Woodstox as its default StAX parser.
+
+  First, copy and Woodstox and its dependencies into the Glassfish domain's <<<lib/ext>>> directory; these
+   files are:
+
+   * woodstox-core-asl-4.0.3.jar
+
+   * stax-api-1.0.1.jar
+
+   * stax2-api-3.0.1.jar
+
+   []
+
+  It is no longer necessary to include these files in a Tapestry WAR, though it doesn't cause problems
+  if they are left in.
+
+
+  Second, use Glassfish's console to configure some system properties:
+
+*---+---+
+|  javax.xml.stream.XMLEventFactory |       com.ctc.wstx.stax.WstxEventFactory
+*---+---+
+|  javax.xml.stream.XMLInputFactory |      com.ctc.wstx.stax.WstxInputFactory
+*---+---+
+|  javax.xml.stream.XMLOutputFactory |    com.ctc.wstx.stax.WstxOutputFactory
+*---+---+
+
+  You will be prompted to restart Glassfish.  Tapestry applications will now deploy properly.
+

Propchange: tapestry/tapestry5/trunk/src/site/apt/glassfish.apt
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: tapestry/tapestry5/trunk/src/site/site.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry5/trunk/src/site/site.xml?rev=765258&r1=765257&r2=765258&view=diff
==============================================================================
--- tapestry/tapestry5/trunk/src/site/site.xml (original)
+++ tapestry/tapestry5/trunk/src/site/site.xml Wed Apr 15 16:14:19 2009
@@ -128,9 +128,10 @@
 
 
         <menu name="Deployment Notes">
+            <item name="Glassfish" href="glassfish.html"/>
+            <item name="JBoss" href="jboss.html"/>
             <item name="Jetty" href="jetty.html"/>
             <item name="Tomcat" href="tomcat.html"/>
-            <item name="JBoss" href="jboss.html"/>
             <item name="WebSphere" href="websphere.html"/>
         </menu>