JBoss Enterprise Application Platform 4.3

Release Notes CP02 FP01

for Use with JBoss Enterprise Application Platform 4.3.0 Cumulative Patch 2 Feature Pack 1

Red Hat Documentation Group

Legal Notice

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
RaleighNC 27606-2072USAPhone: +1 919 754 3700
Phone: 888 733 4281
Fax: +1 919 754 3701
PO Box 13588Research Triangle ParkNC 27709USA

Abstract

These release notes contain important information related to JBoss Enterprise Application Platform 4.3 CP02 FP01 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 CP02 FP01 Feature Pack.


1. Overview

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.

This feature pack provides a fully supported way to upgrade Seam currently included in EAP (Enterprise App Platform) 4.3 to the latest stable, production release (Seam 2.0.2.FP). It also includes a Technology Preview of Hibernate Search 3.0.

2. The details of this Feature Pack

A Feature Pack is a mechanism to add new features to a product outside of the routine major release schedule. All fully supported features included in this feature pack will be included in the next major release of the product (i.e. EAP 5.0). All those features marked Technology Preview in this Feature Pack will also be candidates for inclusion in the next major platform release; though some may still be designated as a Technology Preview.

2.1. Full Production Support

  • Seam 2.0.2.FP

  • Integration with SOA-P 4.3.0.GA

  • Integration with jBPM 3.2.2

  • Integration with Drools 4.0.7

  • Integration with Hibernate Core 3.2, Annotations 3.3, Entity Manager 3.3

  • Integration with RichFaces 3.1

2.2. Technology Preview

  • Hibernate Search 3.0

  • Integration with GWT 1.4

  • Integration with Groovy 1.5

  • Integration with Spring Framework 2.0

  • ICEfaces support for Groovy and the Spring Framework 2.0

Note

GWT, Groovy and Spring Framework are not included in this Feature Pack and are not currently supported by Red Hat.

3. Installation Notes

This section contains information related to installing JBoss Enterprise Application Platform Feature Pack version 4.3.0_CP02_FP01, including hardware and platform requirements and prerequisites.

3.1. Installation Notes

To install this Feature Pack, unpack the contents of the archive into the root of your JBoss Enterprise Application Platform installation, which must be version 4.3.0_CP02.

Important

The contents of the Feature Pack should not be placed within a seperate folder in the EAP directory, but instead it should be intergrated with the current installation.

You must have adequate disk space to install the EAP Feature Pack while also allowing enough space for your applications. You must have a working installation of JDK 1.5 or JDK 1.6 (JDK6) and JBoss Enterprise Application Platform 4.3.0_CP02. 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.

Installation through RHN
To be able to install using RHN, please firstly ensure that you have met the pre-requisites described above and subscribe to the appropriate child channel (refer to the instructions that follow).

Software channels provide a well-defined method to determine which packages should be available to a system for installation or upgrade, based upon its operating systems, packages, and functionality. After logging in to your account on the RHN website at http://rhn.redhat.com you can click on a channel name to view its Channel Details page.

You can use the following steps to subscribe a system to the Application Platform channel. This channel will only be available for a valid subscription. Use the Channels tab to view the software channels available for your account.

  • For a system that is already registered to Red Hat Network (RHN), log in to your account.

  • Select the Systems tab along the top menu. This will bring up the System Overview.

  • If the System Overview menu shows System Groups, select View Systems, to see the Systems list.

  • Select the desired system by clicking the system name link under the System column.

  • Select the Alter Channel Subscriptions link under the Subscribed Channels section (on the right side of the page).

  • To modify the child channels associated with this system, use the checkboxes next to the channels and click the Change Subscriptions button. You will receive a success message or be notified of any errors.

On Red Hat Enterprise Linux 4:
  • Subscribe to the child channels:

    • jbappplatform-4.3.0-[i386|x86_64]-as-4-rpm

    • jbappplatform-4.3.0-fp-[i386|x86_64]-as-4-rpm

  • Run the following command:

    up2date jbossas jboss-seam2 rh-eap-docs jboss-profiler

On Red Hat Enterprise Linux 5:
  • Subscribe to the child channels:

    • jbappplatform-4.3.0-[i386|x86_64]-server-5-rpm

    • jbappplatform-4.3.0-fp-[i386|x86_64]-server-5-rpm

  • Run the following command:

    yum install jboss-seam2 hibernate3-validator rh-eap-docs jboss-profiler

    Note

    Installation of the documentation (rh-eap-docs) and the log-based event profiler (jboss-profiler) are optional but recommended as these will assist you in understanding and troubleshooting the JBoss Enterprise Application Platform.

For instructions on how to migrate your system from Seam 1.2 to Seam 2, refer to chapter 4 of the Seam Reference Guide included with this Feature Pack release. This chapter will guide you through the process.

Support Processes
http://www.redhat.com/support/process/
Production Support Scope of Coverage
http://www.redhat.com/support/policy/soc/production
Production Support Service Level Agreement
http://www.redhat.com/support/policy/sla/production/
Developer Support Scope of Coverage
http://www.redhat.com/support/policy/soc/developer/
Developer Support Service Level Agreement
http://www.redhat.com/support/policy/sla/developer/
Product Update and Support Policy by Product
http://www.redhat.com/security/updates/jboss_notes/
JBoss End User License Agreement
http://www.redhat.com/licenses/jboss_eula.html

4.  Documentation

Refer to the index.html file in the documentation directory for a list of included documentation.

Updated versions of the documentation with errata and additional information, 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/.

5.  Issues and features applied in this release

Following is a list of issues and features applied in this release:

Important

Seam 2.0.2.FP which is included within this Feature Pack now deploys to the EAP production server configuration instead of the default configuration since the EAP executes using the production configuration unless instructed otherwise by the user.

JBPAPP-1113
JBPAPP-1113: The Seam chatroom example would throw javax.naming.NameNotFoundException after a connection attempt. The JNDI names have been updated in order to rectify this issue.
JBPAPP-1108
JBPAPP-1108: Seam examples and seam-gen resources were deployed to the default EAP server configuration when the EAP is setup to deploy the production configuration unless there is specific user instruction to deploy using different settings. To fix this the Seam examples and sem-gen resources were reconfigured to deploy to the EAP production server configuration.
JBPAPP-1107
JBPAPP-1107: The values of jboss.home and tomcat.home should be preset for the Feature Pack release. These values were preset in the build.properties file.
JBPAPP-1094
JBPAPP-1094: When canceling a hotel booking in the Booking example of Seam, a message with the wrong information would be displayed. This has been fixed to display the correct information to the user.
JBPAPP-1087
JBPAPP-1087: The Seam example named Spring was missing the checkout date field on the booking form, with only a label present. Added into the example with this Feature Pack is the missing data field.
JBPAPP-1066
JBPAPP-1066: When referencing to the Hibernate search intergration within Seam, this should be marked as a technology preview.
JBPAPP-1058
JBPAPP-1058: The featured libraries of the Feature Pack should be upgraded to the latest patch version. Appling this upgrades the following components to their mentioned versions:
  • GWT - 1.4.62

  • Groovy 1.5.6

  • Spring 2.0.8

  • RichFaces 3.1.6

JBPAPP-1047
JBPAPP-1047: Intergate fixed issues from Seam 2.0.3.CR1.

The following Seam JIRA issue fixes have been included within this Feature Pack release:

  • JBSEAM-3101: The example of a blog within Seam would generate a XML parsing error when it was launched in a browser. Correcting this issue has been achieved by modifying the code within the import.sql file.

  • JBSEAM-3090: The XSD for the web component namespace would incorrectly declare the servlet-session element. This element is now correctly declared.

  • JBSEAM-3078: New entities to a conversation would not be wrapped by the ServerConversationContext. The issue was fixed so that new entities would be wrapped appropriately.

  • JBSEAM-3071: There was an issue with Seam Mail that would create headers with new lines. To fix this, support has been added for line folding.

  • JBSEAM-3064: An AuthorizationException would occur when Load Testing because the method RuleBasedIdentity.hasPermission() would return false when it should have returned true. Fixing this issue has meant including Drools 4.0.7, including the synchronizeContext() method call that is within hasPermission() within the synchronized block and adding a synchronized block to the hasRole() method.

  • JBSEAM-3058: HTML and CSS sanitation filters for Seam Text would not work correctly. To fix this issue the SeamTextParser.Sanitizer has been backported. However because of this certain style values in plain HTML elements may no longer work.

  • JBSEAM-3053: The ID for a natural conversation was being initialized at the incorrect time, which would lead to exceptions. Correction of this issue has been undertaken by making sure that the ID is initilized at the correct time.

  • JBSEAM-3049: A javax.persistence.EntityNotFoundException error would be thrown when activating passivated entities that had been deleted. This has been corrected by using Hibernate to establish the entity class where possible, but to fall back to lesser methods when Hibernate is not an option.

  • JBSEAM-3027: The seasm-gen richfaces skin called sakura was not avaliable while still being a selectable option. This release fixes this issue by changing the theme to japanCherry.

  • JBSEAM-3003: Parameters within the UrlBuilder would not maintain correct insertion order. This has been corrected by allowing the UrlBuilder to maintain insertion order.

  • JBSEAM-2956: The example within Seam called seambay threw an exception when placing a bid on the camera. This has been corrected by initializing the natural conversation ID at the correct time.

JBPAPP-1020
JBPAPP-1020: Library dependencies needed to be aligned within Seam. To fix this all library dependencies have been aligned to those within EAP 4.3.0.CP02.
JBPAPP-1018
JBPAPP-1018: Components within Seam needed to be marked as Technology Preview. Correcting this means that the following have been marked as Technology Preview:
  • icefaces in seam-gen

  • Groovy integration

  • groovybooking example

  • icefaces integration

  • icefaces example

  • Spring integration

  • spring example

  • portal portlet bridge integration

  • Google Web Kit integration

JBPAPP-1017
JBPAPP-1017: A local Maven repository needed to be created for Drools/JBpm dependencies. In fixing this issue the necessary repo was created.
JBPAPP-1013
JBPAPP-1013: When running the EAP and Seam Unitests running on the same machine, a port conflict would occur. To correct this a change was made in the embedded bootstrap to avoid the port conflict.
JBPAPP-1012
JBPAPP-1012: Unsupported elements of Seam had to be removed. In fixing this issue, the following have been removed from the Feature Pack, except for the meldware libraries, which are required for the org.jboss.seam.mail.Meldware class.

The following is a list of unsupported Seam elements which have been removed from the Feature Pack:

  • Wiki example

  • JEE5 example

  • seam-jbas5 component

  • Container support other than for the EAP has been removed from the examples.

JBPAPP-952
JBPAPP-952: Hibernate, Hibernate Annotations and Hibernate Entity Manager should be upgraded for the Feature Pack. Correcting this means that the following upgrades are included:
  • Hibernate: 3.2.4

  • Hibernate Annotations: 3.3.1

  • Hibernate-Commons Annotations: 3.0.0

  • Hibernate Entity Manager: 3.3.2

  • Hibernate Validator: 3.0.0

A. Revision History

Revision History
Revision 1.0