JBoss Enterprise Application Platform 6

Migration Guide

For Use with JBoss Enterprise Application Platform 6

Edition 2

Sande Gilda

Eamon Logue

Darrin Mison

David Ryan

Misty Stanley-Jones

Keerat Verma

Tom Wells

Legal Notice

Copyright © 2012 Red Hat, Inc..
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.

Abstract

This book is a guide to migrating your application from previous versions of JBoss Enterprise Application Platform.
Preface
1. Document Conventions
1.1. Typographic Conventions
1.2. Pull-quote Conventions
1.3. Notes and Warnings
2. Getting Help and Giving Feedback
2.1. Do You Need Help?
2.2. Give us Feedback
1. Introduction
1.1. About the Migration Guide
2. Prepare for Migration
2.1. Prepare for Migration
2.2. Review What's New and Different in JBoss Enterprise Application Platform 6
3. Migrate Your Application
3.1. Changes Required by Most Applications
3.1.1. Review Changes Required by Most Applications
3.1.2. Class Loading Changes
3.1.3. Configuration File Changes
3.1.4. Logging Changes
3.1.5. Application Packaging Changes
3.1.6. Datasource and Resource Adapter Configuration Changes
3.1.7. Security Changes
3.1.8. JNDI Changes
3.2. Changes Dependent on Your Application Architecture and Components
3.2.1. Review Changes Dependent on Your Application Architecture and Components
3.2.2. Hibernate and JPA Changes
3.2.3. JAX-RS and RESTEasy Changes
3.2.4. LDAP Security Realm Changes
3.2.5. HornetQ Changes
3.2.6. Clustering Changes
3.2.7. Service-style Deployment Changes
3.2.8. Remote Invocation Changes
3.2.9. EJB 2.x Changes
3.2.10. Migrate Seam 2.2 Applications
3.2.11. Migrate Spring Applications
3.2.12. Other Changes That Affect Migration
4. Tools and Tips
4.1. Resources to Assist With Migration
4.1.1. Resources to Assist in Your Migration
4.1.2. Become Familiar with Tools That Can Assist with the Migration
4.1.3. Use Tattletale to Find Application Dependencies
4.1.4. Download and Install Tattletale
4.1.5. Create and Review the Tattletale Report
4.1.6. Use the IronJacamar Tool to Migrate Datasource and Resource Adapter Configurations
4.1.7. Download and Install the IronJacamar Migration Tool
4.1.8. Use the IronJacamar Migration Tool to Convert a Datasource Configuration File
4.1.9. Use the IronJacamar Migration Tool to Convert a Resource Adapter Configuration File
4.2. Debug Migration Issues
4.2.1. Debug and Resolve Migration Issues
4.2.2. Debug and Resolve ClassNotFoundExceptions and NoClassDefFoundErrors
4.2.3. Find the JBoss Module Dependency
4.2.4. Find the JAR in the Previous Install
4.2.5. Debug and Resolve ClassCastExceptions
4.2.6. Debug and Resolve DuplicateServiceExceptions
4.2.7. Debug and Resolve JBoss Seam Debug Page Errors
4.3. Review Migration of Example Applications
4.3.1. Review Migration of Example Applications
4.3.2. Migrate the Seam 2.2 JPA Example to JBoss Enterprise Application Platform 6
4.3.3. Migrate the Seam 2.2 Booking Example to JBoss Enterprise Application Platform 6
4.3.4. Migrate the Seam 2.2 Booking Archive to JBoss Enterprise Application 6: Step-By-Step Instructions
4.3.5. Build and Deploy the JBoss Enterprise Application Platform 5.1 Version of the Seam 2.2 Booking Application
4.3.6. Debug and Resolve Seam 2.2 Booking Archive Deployment Errors and Exceptions
4.3.7. Debug and Resolve Seam 2.2 Booking Archive Runtime Errors and Exceptions
4.3.8. Review a Summary of the Changes Made When Migrating the Seam 2.2 Booking Application
A. Revision History