Bug 1016077

Summary: Provide information about migrating messages using JMS bridge on EAP 6
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: Martin Svehla <msvehla>
Component: DocumentationAssignee: sgilda
Status: CLOSED CURRENTRELEASE QA Contact: Russell Dickenson <rdickens>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 6.2.0CC: jbertram, mnovak, msvehla
Target Milestone: GA   
Target Release: EAP 6.2.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Build Name: 14877, Migration Guide-6.2-1 Build Date: 02-10-2013 13:32:44 Topic ID: 9374-460345 [Latest]
Last Closed: 2013-12-15 16:16:19 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Martin Svehla 2013-10-07 12:56:59 UTC
Title: Configure a JMS Bridge to Migrate Existing JMS Messages to JBoss EAP 6

Describe the issue:

Section describes migrating messages using JMS bridge deployed on EAP 5. Add similar example with using JMS bridge on EAP 6.

Comment 1 Martin Svehla 2013-10-07 12:59:15 UTC
Adding Justin to CC. He's probably the best person to provide info.

Comment 2 Justin Bertram 2013-10-07 13:46:06 UTC
Check this out: https://access.redhat.com/site/solutions/480193

These are general instruction which can be adapted to JBoss Messaging.

Comment 3 sgilda 2013-10-21 20:19:27 UTC
Additional info: 

Additional explanation of individual bridge settings can be also found in upstream documentation: http://docs.jboss.org/hornetq/2.3.0.Final/docs/user-manual/html/jms-bridge.html (although configuration doesn't translate to EAP 1-to-1, so it would be better to consult with developers).

Comment 4 sgilda 2013-10-21 20:21:42 UTC
I am not clear... is this is a 'Migration Guide' issue or an 'Adminstration and Configuration Guide' issue?

Comment 5 Martin Svehla 2013-10-22 06:38:04 UTC
Migration guide (more specific info is in Environment field in this bug).

Comment 6 Martin Svehla 2013-10-22 14:43:47 UTC
Just to be clear about the use case here:

This is about describing how to migrate JMS messages from EAP 5 to EAP 6. EAP 6.0 didn't support JMS bridges, hence the current documentation (with only possibility being the bridge deployed on EAP 5 server).

However since 6.1 JMS bridges are fully supported again, so other option to migrate messages is with the bridge deployed on EAP 6 - this is the part that is missing in the document currently.

The change didn't make it into 6.1 documentation, so it would be nice to manage this for 6.2.

Comment 7 sgilda 2013-10-22 17:34:36 UTC
Thanks Martin. :-)

Comment 9 Justin Bertram 2013-10-24 21:34:25 UTC
All the stuff for "Procedure 3.20" looks good to me.

However, the first sentence in "Procedure 3.19" says, "To avoid conflicts in classes between releases, you must use the following procedure to configure the JMS bridge on JBoss EAP 6.x."

Shouldn't that say "JBoss EAP 5.x" at the end since the bridge is being deployed on JBoss EAP 5.x?

Comment 10 Martin Svehla 2013-10-25 08:17:18 UTC
Sande, the text looks good (apart from version typo Justin pointed out), but I think it's a bit too general for migration guide, it should be a bit more specific for migrating from EAP 5 with JBoss Messaging or from EAP5 with HornetQ.

My suggestion is: leave the text as is, but add an additional paragraph with list of specific client jars and initial naming factory the user needs to use (for both EAP5 with JBM and EAP5 with HornetQ).

Justin, can you please provide the info? Also, will this work for EAP5 with HornetQ? Won't there be any class name conflicts with copying HornetQ 2.2 client jars to EAP6?

Comment 11 sgilda 2013-10-25 13:33:49 UTC
Justin, you are right in your comment above. That should say "To avoid conflicts in classes between releases, you must use the following procedure to configure the JMS bridge on JBoss EAP 5.x.". I fixed that issue in topic 9374.

If you can provide me with a list of JARs, I will try to make it more specific.

Are either of you on IRC? If so, which channels and what nick? I might make this move along more quickly. :-)

Comment 14 Martin Svehla 2013-10-29 08:38:41 UTC
Looks good

Comment 16 Justin Bertram 2014-06-30 14:29:06 UTC
Removed need-info on me.