Release Notes -- 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
