-- Apache Geronimo

 -- Version 2.0 - Milestone 2

Geronimo URLs

-------------

Home Page:     http://geronimo.apache.org/

Downloads:     http://geronimo.apache.org/downloads.html

Documentation: http://geronimo.apache.org/documentation.html

Mailing Lists: http://geronimo.apache.org/mailing.html

Source Code:   http://geronimo.apache.org/svn.html

Bug Tracking:  http://issues.apache.org/jira/browse/GERONIMO

Wiki:          http://cwiki.apache.org/geronimo

IMPORTANT
---------

This is a Milestone release, that means that is not the final version of

Apache Geronimo v2.0 Take a look at "Known Issues and Limitations" section for

further details.

System Requirements

-------------------

You need a platform that supports the Sun JDK 5.0+ (J2SE 1.5.0+).

Most testing has been done on Linux, Mac OS X, and Windows.

Significant Changes in the 2.0

-M2 Release
-----------------------------------------
-

 Java EE management 1.1
- EJB 3.0 support (via OpenEJB integration)  
- Web Services technologies:
 - STAX 1.0 Streaming API for XML (JSR 173)
 - JAXB 2.0 - Java Architecture for XML Binding
 - JAX-WS 2.0 support is provided in this milestone. Only POJO based JAX-WS services are supported. (CXF integration)
 - JAX-RPC 1.1 (POJO Only)
 - JAXR 1.0
- Addition to admin console that allows users to graphically view classloader hierarchy, JNDI tree and module dependencies


*See "Functional Characteristics" section below for more details on the new functions.


Significant Changes in the 2.0-M1 Release (prior milestone)
--------------------------------------------

---------------

- Full Sun JDK 5.0+ (J2SE 1.5.0+)
- Servlet 2.5 (Tomcat)
- JSP 2.1 (Tomcat)
- JSP Debug 1.0 (Tomcat)
- Servlet 2.5 (Jetty)
- JSP 2.1 (Jetty - via Jasper)
- JSP Debug 1.0 (Jetty)
- JSF 1.2 (JSF applications won't execute)
- JSTL 1.2
- Common Annotations 1.0
- JAF 1.1
- JavaMail 1.4
- EJB 3.0 (JPA only)
- JTA 1.1
- JMS 1.1
- JACC 1.1

Functional Characteristics for 2.0-M2
-------------------------------------

- EJB 3.0 (via OpenEJB project)
  Supported:
     - JPA (Custom Provider, App-managed, Container-managed) (Also supported in 2.0-M1)
     - POJO as a Business Interface (both local and remote)
     - POJO Session EJBs
     - geronimo-openejb.xml file not required unless you have geronimo specific information to configure
     - Deployment of annotated beans (@Stateful and @Stateless)
     - Injection via deployment descriptor
     - @Resource injection for env-entries, resource-refs, message-destinations, service-refs,  most resource-env-refs
     - @EJB injection of ejb-refs and ejb-local-refs (Tomcat)
     - @PersistenceContext injection
     - @PersistenceUnit injection
     - JNDI references to the ejb
     - JNDI references from the ejb
     - Transaction support
     - Legacy component (i.e. home) interfaces on a Pojo session bean
     - Xml-based *and* annotation-based injection for ejbs, except for message-destinations,
       or SessionContext when the field or setter is not named setSessionContext
     - References to business interfaces, local or remote, from a servlet or an ejb
     - References to home interfaces, local or remote, from a servlet or an ejb
     - Extended JNDI and DI types
     - Deploy and Undeploy

     Simple EJB 3.0 example application available at:
       http://cwiki.apache.org/confluence/display/GMOxDOC20/Using+some+of+EJB+3.0+functionalities
     
  Limitations:
     - No support for MDBs.
     - @EJB injection of ejb-refs and ejb-local-refs (Jetty)


- Web Services (CXF)
  Supported:
     - Deployng a JAX-WS based POJO service that leverages annotations to simplify the creation of the Web service.  
     - Deploying a traditional JAX-RPC based POJO service
     - @Resource Annotations are fully supported provided they are also defined in the web.xml deployment descriptor
     - The @Resource WebServiceContext annotation is fully supported.  

     Simple Web Services example available at: http://cwiki.apache.org/GMOxDOC20/simple-web-service-with-jax-ws.html

  Limitations:
     - No EJB support for Web Services in 2.0-M2
     - <service-ref> elements in the deployment descriptor or @WebServiceRef annotations are not processed.
     - Dynamically generated WSDL returned via ?wsdl request might be missing some information.
     - Dynamic clients (obtained using the javax.xml.ws.Service API) might not always work.


- JSTL 1.2
   Applications that use JSTL must add a dependency in their deployment plan to the jstl jar.
   Specifically:
    <dep:dependencies>
     <dep:dependency>
      <dep:groupId>jstl</dep:groupId>
      <dep:artifactId>jstl</dep:artifactId>
      </dep:dependency>
    </dep:dependencies>
   Alternatively, the jstl jar can be included in the application's WEB-INF/lib directory.


- JSF 1.2 - Not yet supported
 -JSF applications will deploy and start but will not execute yet. An updated MyFaces package
  will remedy this in the near future.


Installing & Starting Geronimo
------------------------------
To install, simply unpack the .zip (Windows) or tar.gz (Unix) file containing
Geronimo.

If you wish to modify the default ports that Geronimo will use, edit the file
<geronimo_home>/var/config/config.xml

Geronimo comes with batch and script files to control server start and stop
functions.  To see usage examples simply type geronimo.bat or geronimo.sh
command as appropriate for your platform.  It is necessary to set JAVA_HOME to
the copy of your Sun 5 JDK/JRE prior to executing the command.  

Here is an example to set JAVA_HOME:

export JAVA_HOME=<JDK/JRE_home>

To see the available command options type:

<geronimo_home>/bin/geronimo.sh
or
<geronimo_home>\bin\geronimo.bat

The command will display help text instructing you as to how to start and stop
the Geronimo server.

If you prefer to start the server without a script file you can simply type:

java -jar <geronimo_home>/bin/server.jar

Once the server has started, you can access the Geronimo Administration Console
at http://localhost:8080/console/ . The default user name is "system" and the
default password is "manager".


Administration Console Security Configuration
---------------------------------------------
The default administration user/password for the Geronimo Administration Console
and command line deployment tool is system/manager.  You can change these defaults
directly from the Geronimo Administration Console by accessing Security -> Console
Realm and change the user name and password from the Console Realm Users portlet.

As an alternative, you can make the same changes by editing the
<geronimo_home>/var/security/users.properties and
<geronimo_home>/var/security/groups.properties files.


Deploying Applications
----------------------
Geronimo comes with deploy scripts and batch files to deploy J2EE modules or
applications. You can use the scripts or simply invoke the executable jar by
running the following command (note that you need to start Geronimo first):

<geronimo_home>/bin/java -jar deployer.jar deploy my-web-app.war [deploy plan]

You will need to use the username "system" and password "manager" unless you
customized those as described above.  The deployment plan argument is
optional -- you can pack a deployment plan into the application module, provide
it on the command line, or in some cases omit it entirely.

You can also use the "Login" command to avoid entering a user name and password
every time you use the deploy tool

For more information on the commands and options supported by the deploy tool,
run from within the Geronimo directory <geronimo_home>/bin:

java -jar deployer.jar help [command]

You can also graphically deploy applications and resources via the Geronimo
Administration Console available at http://localhost:8080/console/


Other Deployment Options
------------------------
As an alternative to the command-line deployer, you can copy application
modules into the <geronimo_home>/deploy/ directory and the
hot deployer service will deploy them automatically.  The command-line deployer
has some advantages, as it will output any
deployment errors to its own console rather than just the server log.

Additionally, Geronimo provides a Maven plugin that can deploy applications to
Geronimo as part of a Maven build.


Configuration
-------------
Most configuration attributes can be updated in the
<geronimo_home>/var/config/config.xml file.  The attributes most likely to be
changed are already included in the supplied config.xml file, while others may
need to be added manually.


Certification Status
--------------------
Apache Geronimo v2.0-M2, being a MILESTONE release is not yet certified.


Known Issues and Limitations
----------------------------
<!-- open Bugs for 2.*  -->
GERONIMO-2779  JNDI, Dependency, and ClassLoader views don't work with Safari browser  
GERONIMO-2778  Deployer should always fill in required <local> or <remote> interfaces elements in <ejb-ref>  
GERONIMO-2775  Enabling web statistics collection for jetty fails from the admin console  
GERONIMO-2773  cannot create a new jetty http connector from console  
GERONIMO-2771  GlassFish specs are being included in 2.0-M2 builds  
GERONIMO-2768  geronimo-j2ee-management_1.1_spec is still using geronimo-ejb_2.1_spec instead of new ejb_3.0_spec  
GERONIMO-2766  cannot restart a tomcat http connector from the console  
GERONIMO-2763  JACC URLPatternSpec does not accept *do:login.do as it should  
GERONIMO-2754  Server wont start on Revision: 497496  
GERONIMO-2749  AbstractWebModuleBuilder needs to support HTTP extension methods per jacc 1.1  
GERONIMO-2747  Error while shutting down Geronimo  
GERONIMO-2744  App client needs to be able to log out  
GERONIMO-2741  Info messages are being displayed in the console output  
GERONIMO-2737  Server shutdown time has increased significantly because of ActiveMQ v4  
GERONIMO-2734  Client container does not terminate  
GERONIMO-2730  JAX-RPC EJB Web Services support appears to be broken  
GERONIMO-2699  Module was not a war  
GERONIMO-2696  SQL Exception: Failed to start database  
GERONIMO-2694  STATUS file sent out as the Geronimo Weekly Status email needs updating  
GERONIMO-2688  no-pool and xa-transaction with no caching result in connections being closed before the tx ends.  
GERONIMO-2687  All "default" Subjects should be obtained by logging in to a realm, not constructed explicitly  
GERONIMO-2682  Sending a message throws a SendFailedException  
GERONIMO-2681  IOException when reading content of a message  
GERONIMO-2680  mod_jk configfilegenerator produces unusable configentries  
GERONIMO-2676  Web Application without required jars throws NullPointer  
GERONIMO-2675  Fix geronimo assemblies  
GERONIMO-2673  WARN message from Global JNDI  
GERONIMO-2668  axis deployer still assumes it's the only one  
GERONIMO-2666  NPE in JavaComponentContext  
GERONIMO-2664  Servlet Filter Error  
GERONIMO-2657  Persistence-* builders need improvements  
GERONIMO-2655  Jetty 6 assemblies do not include sample AJP Connectors  
GERONIMO-2654  Enabling Welcome App (context "/") on geronimo-jetty6-jee5 assembly breaks web-console (context "/console")  
GERONIMO-2650  JSP 2.1 error in Jetty/Tomcat  
GERONIMO-2643  Stack trace (due to amq) while shutting down Geronimo  
GERONIMO-2626  Building geronimo-kernel leaves 46 files in java.io.tmpdir  
GERONIMO-2622  Implement PolicyContextHandlerSOAPMessage  
GERONIMO-2605  NPE if exporting plugin for module having dependency on module with no groupId  
GERONIMO-2598  Deploy tool prints useless message if configuration start fails  
GERONIMO-2481  WebServers portlet: Create/Edit Tomcat Connectors should support editing of all supported connector attributes  
GERONIMO-1939  Server Info portlet doesn't display the 'Server Memory Usage' live graph on Internet Explorer 




Specific Issues, Features and Improvements fixed in Version 2.0-M2
------------------------------------------------------------------
<!-- closed/fixed JIRAs  for 2.*  -->
GERONIMO-2746  use dependencymanagement for some axis2 dependent modules  FIXED  
GERONIMO-2752  Axis2 integration displays invalid information for URL requests  FIXED  
GERONIMO-2764  Clustered HttpSessions are not properly destroyed during eviction  FIXED  
GERONIMO-2679  ArrayIndexOutOfBoundsException when getting Mails from Pop3-Account with geronimo-javamail_1.4_mail-1.0.jar  FIXED  
GERONIMO-2774  Server memory usage graph does not work  FIXED  
GERONIMO-2706  Unable to create database pool  DUPLICATE  
GERONIMO-2728  Exception while removing directory module from the console  FIXED  
GERONIMO-1519  ResourceException.toString() can return null  FIXED  
GERONIMO-2653  Inconsistencies between jetty6-builder and tomcat6-builder plan.xml files  FIXED  
GERONIMO-1657  CommandSupport doesn't bubble up the exception. Prints stacktrace.  FIXED  
GERONIMO-2769  EarConfigBuilder ignores geronimo plan if no application.xml present  FIXED  
GERONIMO-2714  FileAuditLoginModule fails to write login attempts  FIXED  
GERONIMO-2745  NPE at org.apache.geronimo.security.SubjectId.hashCode(SubjectId.java:79)  FIXED  
GERONIMO-2027  Mismatched passwords when editing user in web console  FIXED  
GERONIMO-2751  [BUILD BREAK] Module geronimo-axis2  FIXED  
GERONIMO-2753  the "namingProviderUrl" element does *not* appear to control which IP addresses the RMI service binds to  FIXED  
GERONIMO-2642  welcome app not included in the jetty assembly.  FIXED  
GERONIMO-2683  Multiple versions of org.codehaus.wadi.wadi-tribes listed in server/trunk/pom.xml  FIXED  
GERONIMO-2685  database pool type emty in pool creation wizard - Jetty  FIXED  
GERONIMO-2740  Filter out the Tomcat debug log msg - java.lang.ClassNotFoundException: org.apache.tomcat.util.net.puretls.PureTLSImplementation  FIXED  
GERONIMO-2686  database creation pool wizzard fails to deploy  FIXED  
GERONIMO-2560  Realm added using SecurityRealm portlet does not work  FIXED  
GERONIMO-2748  DB Manager portlets (DB Viewer and Run SQL) not working  FIXED  
GERONIMO-2579  TestNG testcases in testsuite broken. JUnit expected. Move to JUnit 4.0 ?  WON'T FIX  
GERONIMO-2580  CorbaRefBuilder inserts ref for java:comp/CORBA that fails when corba gbean is not present.  FIXED  
GERONIMO-2587  FileKeystoreInstance.loadKeystoreData() results in inconsistent state if wrong password is supplied  FIXED  
GERONIMO-2586  KeystorePortlet: Unlock keystore for availability shows key aliases only when keystore is unlocked for edit  FIXED  
GERONIMO-2585  KeystorePortlet: Lock keystore throws NullPointerException  FIXED  
GERONIMO-2588  KeyStorePortlet: Locking and unlocking could use some error and info messages  FIXED  
GERONIMO-2592  TSSLink doStart() method is not getting called.  FIXED  
GERONIMO-2590  The TSSLinkBuilder is not included in the list of loaded builders.  FIXED  
GERONIMO-2591  Database Pools portlet: Create new pool dependency jar selection problems  FIXED  
GERONIMO-2602  default compile scope is overloaded with 2 meanings in PlanProcessorMojo  FIXED  
GERONIMO-2603  Building 1.2 if there are 2.0 artifacts in the repo results in mostly 2.0 artifacts in the server.  FIXED  
GERONIMO-2692  Current specs/trunk fails to build, due to missing modules  FIXED  
GERONIMO-2611  Configuration should not have duplicates in allServiceParents  FIXED  
GERONIMO-2709  Database creation pool wizard fails in Jetty  FIXED  
GERONIMO-2615  Not enough info when a gbean ref can't be verified during deployment  FIXED  
GERONIMO-2619  Javamail 1.4 spec needs to be using the JAF 1.1 version.  FIXED  
GERONIMO-2722  enable commons-logging in tomcat module  FIXED  
GERONIMO-2623  Infinite loop in the SMTPTransport code when a socket factory class is used.  FIXED  
GERONIMO-2624  Offline deployer busted  FIXED  
GERONIMO-2625  Geronimo Console: login page prevents using username, password longer than 25 characters for login  FIXED  
GERONIMO-2627  jsr88 classpath is all messed up  FIXED  
GERONIMO-2631  jetty5 builder needs to parameterize the jsp servlet class  FIXED  
GERONIMO-2684  Upgrade server trunk (2.0) to use the latest released geronimo-spec versions  FIXED  
GERONIMO-2632  Connection errors can result in infinite loop  FIXED  
GERONIMO-2630  sun j2ee schemas are being redistributed in jsp and servlet specs  FIXED  
GERONIMO-2641  Missing license headers  FIXED  
GERONIMO-2644  Fix leaking ClassLoaders  INVALID  
GERONIMO-2646  WAR without a geronimo-web.xml deploys to the wrong context  FIXED  
GERONIMO-2649  Insert of new EJB does not appear to be occurring  FIXED  
GERONIMO-2652  XmlBeans is having trouble validating some xml from substitution groups  FIXED  
GERONIMO-2656  for jetty, in servlet-mapping, url patterns must be trimmed.  FIXED  
GERONIMO-2659  jspc plugin busted by spec >> provided change  FIXED  
GERONIMO-2663  Build Break ! at configs/client-deployer  CANNOT REPRODUCE  
GERONIMO-2669  fix o.a.g.j.ClusteredSessionManager to match changes in Jetty AbstractSessionManager  FIXED  
GERONIMO-2720  tomcat https connector needs additional param  FIXED  
GERONIMO-1585  Web app security on /* causes deployment exception  FIXED  
GERONIMO-2674  The basic CXF integration is not working  FIXED  
GERONIMO-2732  J2EE Application Client deployment fails with NPE  FIXED  
GERONIMO-2711  specs/trunk fails to build  FIXED  
GERONIMO-2721  Unable to deploy anything  FIXED  
GERONIMO-2713  LDAP Realm fails to test and deploy  FIXED  
GERONIMO-2105  When redeploying with no version number, new entries in config.xml break  FIXED  
GERONIMO-2689  New View for JNDI name in all the contexts  FIXED  
GERONIMO-2691  New view for the hierarchical modules and linked dependencies  FIXED  
GERONIMO-2750  Remove Depricated Code from Axis2 Integration  FIXED  
GERONIMO-2719  Use released Jetty 6.1 in Geronimo 2.0-M2  FIXED  
GERONIMO-2600  Upgrade to Derby 10.2.2.0  FIXED  
GERONIMO-2589  Generate explicit-versions.properties transitvily  FIXED  
GERONIMO-2594  Add xalan to endorsed directory  FIXED  
GERONIMO-2716  Create javaee 5 test jars for j2ee-builder tests  FIXED  
GERONIMO-2597  Make web service builder optional  FIXED  
GERONIMO-2604  Create a specs pom  FIXED  
GERONIMO-2608  JACC 1.1 support (jsr-115 MR4)  FIXED  
GERONIMO-2616  Move jee5 work from sandbox to trunk  FIXED  
GERONIMO-2629  Upgrade to J2EE Management 1.1 (JSR77)  FIXED  
GERONIMO-2634  Switch to activemq 4.1.0-incubator: include apache incubator repo in our repo list.  FIXED  
GERONIMO-2635  Upgrade to JavaMail 1.4 and JavaBeans Activation Framework 1.1  FIXED  
GERONIMO-2761  Upgrade to Log4J 1.2.14 maintenance release  FIXED  
GERONIMO-2648  Integrate JSF 1.2 into 2.0-M1  FIXED  
GERONIMO-2662  remove jetty5 support from trunk and 2.0-m1  FIXED  
GERONIMO-2783  CXF-based WebServices support: webservices.xml file is no longer required  FIXED  
GERONIMO-2725  Remove geronimo-qname_1.1_spec usage  FIXED  
GERONIMO-2726  Update JAXB and StAX implementation versions  FIXED  
GERONIMO-2762  Updated JAX-WS tests  FIXED  
GERONIMO-2690  New view for all the classloaders and classes loaded in it  FIXED  
GERONIMO-2628  Upgrade to tomcat 6.0.2 beta  FIXED  
GERONIMO-2770  Ejb Deployment with no ejb-jar.xml  FIXED  
GERONIMO-2718  Upgrade to tomcat 6.0.7 beta  FIXED  
GERONIMO-2772  Support for EJB 3 descriptors and previous  FIXED  
GERONIMO-2777  Expose JAX-WS mandatory MessageContext properties  FIXED  
GERONIMO-2636  Update Jetty 6 assembly to use Jasper 6 for JSP 2.1 support  FIXED  
GERONIMO-2535  Support Java EE 5 Common Annotation Spec in Geronimo (JSR 250)  FIXED  
GERONIMO-2667  Streaming API for XML integration  DUPLICATE  
GERONIMO-2671  Streaming API for XML and JAXB integration  FIXED  
GERONIMO-2738  JAXB, STAX support for client applications  FIXED  
GERONIMO-2727  Enable axis2-deployer in jetty and tomcat jee5 assemblies  FIXED  
GERONIMO-2536  Support Java EE 5 JavaServerPages Standard Tag Library in Geronimo (JSTL, JSR 52)  FIXED  
GERONIMO-2729  JAX-RPC POJO WS tests  FIXED  
GERONIMO-2756  Basic @Resource injection for CXF web services  FIXED  
GERONIMO-2781  Improved CXF-based POJO WebService support  FIXED  
GERONIMO-2601  Remove the "Old Keystore" portlet  FIXED  
GERONIMO-2639  Upgrade dojo to 0.4.1  FIXED  
GERONIMO-2658  Add 2.0-M1 Release Notes  FIXED  
GERONIMO-2670  Update geronimo plugin repository version  FIXED  
GERONIMO-2760  Upgrade tomcat to version 6.0.8a  FIXED  
GERONIMO-2755  JSP tests for web-testsuite  FIXED  
GERONIMO-2620  Need to create javamail 1.4 versions of the provider and mail jars  FIXED