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