[weld-commits] Weld SVN: r7217 - archetypes/javaee6-webapp/trunk.

[weld-commits at lists.jboss.org]

Author: dan.j.allen
Date: 2011-03-31 18:00:40 -0400 (Thu, 31 Mar 2011)
New Revision: 7217

Modified:
   archetypes/javaee6-webapp/trunk/readme.txt
Log:
add note about upgrading Weld in GlassFish 3.1


Modified: archetypes/javaee6-webapp/trunk/readme.txt
===================================================================
--- archetypes/javaee6-webapp/trunk/readme.txt	2011-03-31 22:00:25 UTC (rev 7216)
+++ archetypes/javaee6-webapp/trunk/readme.txt	2011-03-31 22:00:40 UTC (rev 7217)
@@ -18,12 +18,13 @@
  ===================
 
  All you need to build this project is Java 5.0 (Java SDK 1.5) or better, Maven
- 2.0.10 or better. We strongly recommend, however, that you use Java 6.0 (Java
- SDK 1.6) and Maven 3.0 or better.
+ 3.0 or better. We strongly recommend, however, that you use Java 6.0 (Java SDK
+ 1.6).
 
  The application this project produces is designed to be run on a Java EE 6
  application server. We recommend JBoss AS 6.0.0.Final or GlassFish 3.1, though
- it should work on any server that is Java EE 6 compliant.
+ it should work on any server that is Java EE 6 compliant. In order to use it
+ on GlassFish 3.1, you'll need to update Weld. See instructions below.
  
  NOTE:
  This project retrieves artifacts from the JBoss Community Maven repository, a
@@ -108,6 +109,9 @@
  deploys the application. NetBeans then provides incremental deployment of web
  resources.
 
+ IMPORTANT:
+ Don't forget to upgrade Weld. See Upgrading Weld in GlassFish 3.1 for details.
+
  You can also start GlassFish from the commandline. Change to the glassfish/bin
  directory in the GlassFish install root and run these three commands (leading
  ./ not required on Windows):
@@ -133,6 +137,22 @@
 
   ./asadmin undeploy jboss-javaee6-webapp-src
 
+ Upgrading Weld in GlassFish 3.1
+ ===============================
+
+ There are several known CDI visibility issues in the stock version of Weld
+ that ships with GlassFish 3.1. One of these issues affects the sample code in
+ this application. For more information, see http://sfwk.org/Seam3/Compatibility.
+ 
+ You can upgrade Weld by following these steps:
+
+ 1. Stop GlassFish
+ 2. Download the most recent Weld OSGi Bundle 1.1.0-SNAPSHOT (https://repository.jboss.org/nexus/content/repositories/snapshots/org/jboss/weld/weld-osgi-bundle/1.1.0-SNAPSHOT)
+ 3. Copy that jar to $GLASSFISH_HOME/glassfish/modules/weld-osgi-bundle.jar
+ 4. Start GlassFish
+
+ You can now deploy the application successfully to GlassFish 3.1.
+
  Running the Arquillian tests
  ============================
 
@@ -245,8 +265,8 @@
    - Quickstart:         http://tinyurl.com/gojavaee
    - Issue tracker:      https://issues.jboss.org/browse/WELDRAD
    - Source code:        http://anonsvn.jboss.org/repos/weld/archetypes
-   - Forums:             http://seamframework.org/Community/WeldUsers
- - JSR-299 overview:     http://seamframework.org/Weld
+   - Forums:             http://sfwk.org/Community/WeldUsers
+ - JSR-299 overview:     http://sfwk.org/Weld
  - JSF community site:   http://www.javaserverfaces.org
  - Download JBoss AS:    http://jboss.org/jbossas/downloads
  - Download GlassFish:   http://glassfish.java.net/public/downloadsindex.html