Copyright © 2008 Red Hat, Inc
Copyright © 2008 Red Hat, Inc. This material may only be distributed subject to the terms and conditions set forth in the Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License (which is presently available at http://creativecommons.org/licenses/by-nc-sa/3.0/).
Red Hat and the Red Hat "Shadow Man" logo are registered trademarks of Red Hat, Inc. in the United States and other countries.
All other trademarks referenced herein are the property of their respective owners.
The GPG fingerprint of the security@redhat.com key is:
CA 20 86 86 2B D6 9D FC 65 F6 EC C4 21 91 80 CD DB 42 A6 0E
1801 Varsity Drive
Raleigh, NC 27606-2072USAPhone: +1 919 754 3700
Phone: 888 733 4281
Fax: +1 919 754 3701
PO Box 13588Research Triangle Park, NC 27709USA
These release notes contain important information related to JBoss Enterprise Application Platform 4.3.0.CP02 that may not be currently available in the Product Manuals. You should read these Release Notes in their entirety before installing JBoss Enterprise Application Platform 4.3.0.CP02.
These release notes contain important information related to JBoss Enterprise Application Platform 4.3.0.CP02. New features, known problems, resources, and other current issues are addressed here.
JBoss Enterprise Application Platform is the next evolutionary step in open source enterprise software. It is a powerful tool for developing rich, high performance, Web 2.0 applications on a pure Java Platform.
JBoss Enterprise Application Platform provides complete compatibility with existing J2EE 1.4 enterprise Java applications. At the same time, almost all the key features and components defined in the Java EE 5.0 specification are supported. So your new enterprise Java applications can take immediate advantage of the Java EE 5.0's significantly simpler POJO-based programming model.
Further, by integrating best-of-breed open source frameworks such as JBoss Seam, Hibernate, Tomcat, and JBoss Cache the Platform takes advantage of innovations in the open source community. As well, JBoss Enterprise Application Platform is fully tested and supported by Red Hat, and is certified to work on many leading enterprise hardware and software products.
All of which means you can develop your new application taking advantage of Java EE 5.0 technologies immediately and with the confidence of knowing it will remain forward-compatible with future versions of the JBoss Platform.
In JBoss Enterprise Application Platform 4.3, JBoss MQ 1.3 has been replaced with JBoss Messaging 1.4. JBoss Messaging provides a high performance messaging infrastructure for JBoss Enterprise Application Platform.
JBoss Web Services is upgraded to 2.0.1 in JBoss Enterprise Application Platform 4.3 and will now provide a complete implementation of JAX-WS.
This section contains information related to installing or upgrading to JBoss Enterprise Application Platform version 4.3.0.CP02, including hardware and platform requirements and prerequisites.
You must have adequate disk space to install JDK and JBoss Enterprise Application Platform while also allowing enough space for your applications. You must have a working installation of JDK 1.5. For the latest information on supported Operating System / JVM combinations, supported Database platforms and current information on the revision level of included components, please refer to http://www.jboss.com/products/platforms/application/testedconfigurations. Refer to the installation guide available online from http://www.redhat.com/docs/en-US/JBoss_Enterprise_Application_Platform/ for detailed instructions to install and verify JBoss Enterprise Application Platform.
It is recommended to run the example Seam applications that are included with the documentation using the production configuration. Using another configuration may result in memory issues. Note that the default configuration for the server to start with, if no other configuration is specified, is the production configuration.
To avoid memory issues, adjust the memory settings before deploying the applications. You can do this by updating JAVA_OPTS settings in the file JBOSS_DIST/jboss-as/server/production/run.conf with these recommended values:
-Xms1303m -Xmx1303m -XX:PermSize=256m -XX:MaxPermSize=256m
Refer to the "Seam Reference Guide" included in the documentation set (JBOSS_DIST/doc/seam/Seam_Reference_Guide.pdf) for important information regarding the deployment of Seam examples and detailed information on developing applications using Seam.
If you are using the rpm, or the zip distribution, please note that by default, authentication is enabled and no user accounts are set up. This is done to prevent unauthorized access to various services of JBoss AS. Please refer to the Installation Guide, or see http://kbase.redhat.com/faq/FAQ_107_9963.shtm for information on how to make the services accessible again.
Hypersonic SQL provides default "out of the box" database functionality for evaluation and development use only. It is NOT recommended or supported as a production-use database. Technical support is not available for this component, and while we are happy to accept bugs filed against this component, we do not make any commitment to fix them within a specific timeframe.
Refer to the index.html file in the documentation directory for a list of included documentation.
In the zip distribution, documentation for the Platform and its individual components is distributed in a separate zip file, jboss-eap-docs-<version>.zip.
On a Linux system, the documentation is found in two rpms that will need to be installed manually. These rpms are jboss-seam-docs-<version>.noarch.rpm, and rh-eap-docs-<version>.noarch.rpm. For help with installing rpm packages on Red Hat Enterprise Linux, please refer to the Red Hat Knowledge base article located at http://kbase.redhat.com/faq/FAQ_35_198.shtm
Installation Guide explains how to install and verify the installation of JBoss Enteprise Application Platform using different installation modes.
Getting Started details the directory structure of the platform and a quick tour of the Application Server and different configuration sets and services. Using a simple web application it illustrates the use of JSF-EJB3 components and how to use Seam to integrate the JSF and EJB3 components.
Server Configuration Guide explains all administrative and configuration functions in detail.
Updated versions of the documentation with errata and additional information, example application code, as well as the most recent version of the release notes may be accessed via the web from http://www.redhat.com/docs/en-US/JBoss_Enterprise_Application_Platform/.
Following is a list of issues fixed in this release:
JBPAPP-925: JBoss Messaging has been upgraded to version 1.4.0.SP3_CP03. This update includes numerious bug fixes that improves the overall component.
JBPAPP-920: The JBoss Messaging documentation was outdated. This CP release contains the JBoss Messaging 1.4.0.SP3_CP03 User Guide.
JBPAPP-900: The SQL default configuration had errors, causing an issue within hsqldb which uses this configuration. The issue with the default configuration has now been corrected.
JBPAPP-813: The Messaging client included a bug that would make it hang forever, creating a ClusteredConnectionFactory failover; steaming from a socket hang. This issue has now been rectified in this latest EAP release, creating a more stable Messaging component.
JBPAPP-735: The JBoss Remoting component of the EAP has been upgraded to version 2.2.2.SP9. This upgrade includes numerious bug fixes.
JBPAPP-930: The upgrade to JBossWS Common 1.0.0.GA_CP01 is included wihtin this CP release.
JBPAPP-887: JBoss Java API for XML Redistries (JAXR) has been upgraded to version 1.2.0.SP1 which addresses various bugs.
JBPAPP-791: The JBoss Web Services Component has been upgraded to version 2.0.1.SP2_CP02. This upgrade incorporates various bug fixes and enhancements.
JBPAPP-755: The Seam source readme.txt file required updated links to seamframework.org and mention the EAP instead of the JBoss AS. This file has been updated with the above changes for this release.
JBPAPP-938: An unchanged parent entity would incorrectly have its version value incremented when part of a one to many relationship. This error has been rectified with this latest CP release by correcting an issue in the CollectionType.java file and adding the a new method called testNoExtraUpdatesOnPersistentMergeVersionedWithCollection() to MergeTest.java.
JBPAPP-936: The AnnotationBinder.mustBeSkipped method had an incorrect hardcoded String-Reference to the org.hibernate.tool.instrument.javassist.FieldHandler class. This error has meant that the junitinstrument test was not running correctly. This issue has been fixed, with the correct package location of the class being referenced with the class name org.hibernate.bytecode.javassist.FieldHandler and the junitinstrument test now runs successfully.
JBPAPP-915: A merge operation would fail when there was a transient entity that was reachable by multiple paths and at least one of these paths did not cascade when undertaking a merge. This issue is fixed with the EAP 4.3 now supporting JDK 6.
JBPAPP-908: Hibernate proxy serialization was broken because the AbstractLazyInitializer class was not Serializable. This is now corrected within this CP release.
JBPAPP-899: There was an error within the entity manager where the methods getSingleResult() and fetch() would return a NonUniqueResultException because elements were now unique. This issue has been corrected with this CP release.
JBPAPP-859: The SchemaUpdate class has been enhanced with output file name, delimiter, halt on error, format options now avaliable.
JBPAPP-782: The MapBinder class had the ability to generate SQL statements that would not be supported by the Oracle 10g database. This was of particular concern for some EJB3 Persistence users on EAP and Oracle. This issue has now been rectified in this CP release.
There are no Security Issues addressed with this CP releae.
ClusteredSession included logic that would skip session metadata replication if the only change was the timestamp. This issue was corrected by changing the default maximum interval between requests. The default interval is now 60 seconds and the value is now configurable. This attribute can be changed by adding an atribute to the jboss-service.xml file that resembles
<attribute name="MaxUnreplicatedInterval">30</attribute>.
run.conf file:
-Dsun.lang.ClassLoader.allowArraySyntax=true.
invoke results, even with the absense of a property editor for the returned object. Corrected within this CP release, Twiddle now calls the toString() method on returned objects when there is no property editor found.
ClassCastExceptions when being used. This update corrects this issue so that serialization functions correctly.
ExceptionSorter interface implementation should be provided for users of the IBM DB2 Data Server. This enhancement to the EAP is included within this CP release.
It is important to note that a regular jbossas installation is required on the server first before installtion of the -bin. The -bin is for an additional installation only and cannot be used in place of a regular RPM jbossas installation. If you only have one version of the AS, it will have to be the regular RPM installation (or ZIP or installer for older versions).
mail-ra.rar used within the application server to recieve email from using the JavaMail API, was missing from the distribution. This missing file has now been re-included.
driver-class has been updated from com.microsoft.jdbc.sqlserver.SQLServerDriver to com.microsoft.sqlserver.jdbc.SQLServerDriver and the default port for the connection-url has been changed from 1433 to 3918. With these changes the example now functions correctly under SQL Server 2005.
-ds.xml and the option to ValidateDTDs was set to true in jbossjca-services.xml, validation errors would occur. This was found to be because of an issue with the tx-connection-factory element in jms-ds.xml which has since been fixed.
EchoSecurityProxy.java file has now been restored, enabling the example to be run correctly.
FaceletException error. This issue was caused from the inclusion of incorrect .jar files for the example. This CP update includes the correct .jar files, correcting the issue and allowing the example to execute correctly.
RuntimeException. The ability to accomplish this is now included.
Following is a list of known issues at the time of release.
JBPAPP-909: Within the Hibernate component of the EAP the HashMap and HashSet iteration order changed from past releases because of support for JDK 1.6. However this has meant that the order of columns in union clauses and union-subclasses has changed, generating a slight impact on the components performance.
| Revision History | |||
|---|---|---|---|
| Revision 1.0 | |||
|
| |||