Please provide a description of what would be needed in this documentation, or a URL to existing information that can be used as a base.
You can find some informations in discussion in bug 999344 as well
*** Bug 999344 has been marked as a duplicate of this bug. ***
Thanks Martin.
I can take this one.
Started the topic here: Create a JMS Bridge [34417]
Hi Sande, there is already chapter about JMS bridges in Migration Guide [1] - in Procedure 3.18. Configure the JMS Bridge deployed to a JBoss EAP 6.x Server. We could provide link just to this doc. Relevant is really just the second procedure "3.18. Configure the JMS Bridge deployed to a JBoss EAP 6.x Server" Thanks, Mirek [1] http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Migration_Guide/index.html#Configure_a_JMS_Bridge_to_Migrate_Existing_JMS_Messages_to_Enterprise_Application_Platform_6
Hi Mirek, I thought it sounded familiar. Yes, I wrote that topic 2 or 3 years ago. :-) I think I need to break that topic into multiple topics. Then the one portion could be included in the Administration and Configuration Guide or the Development Guide. Thanks for the reminder! Sande
I removed the procedures from the the existing topic: Configure a JMS Bridge to Migrate Existing JMS Messages to JBoss EAP 6 [9374] I created a new topic: Create a JMS Bridge [34417] The topic title makes it more generic so it can be used in any guide.
Hi Sande, I can see there is also chapter "Configuring HornetQ JMS Bridge [31365]" in Section: Configuration. Can you merge it with it what is already there. Configuration from migration guide appears to be more detailed. Thanks, Mirek
Hi Mirek, That section is "Configuration" and I think the topic that is there has a little different viewpoint. The new topic is more of a 'how-to' use case. I think merging the separate topics into one topic might make it too complex. I think there are 2 options: 1) Add the new topic to the section I noted above, but add a note at the end of the existing topic "Configuring HornetQ JMS Bridge" that says: For more complete instructions, see "How to Create a JMS Bridge". OR For more information, see the section entitled "JMS Bridges". 2) Add the new topic to the section you mention, but keep it separate: Section: Configuration Configure the JMS Server [111] Configure JMS Address Settings [8537] Configure Messaging with HornetQ [4371] Configuring HornetQ Core Bridge [31325] Configuring HornetQ JMS Bridge [31365] Create a JMS Bridge [34417] <!-- NEW TOPIC --> Configure Delayed Redelivery [640] Configure Dead Letter Addresses [643] Configure Message Expiry Addresses [650] Reference for HornetQ Configuration Attributes [9087] Set Message Expiry [649] My preference is number 1), but I will defer to your opinion. :-) Thanks, Sande
You're right, I'm for first option: 1) Add the new topic to the section I noted above, but add a note at the end of the existing topic "Configuring HornetQ JMS Bridge" that says: For more complete instructions, see "How to Create a JMS Bridge". Thanks, Mirek
I can see the link in chapter 18.6.4 and not in 18.6.5. Configuring HornetQ JMS Bridge. Otherwise it looks ok to me.
*** Bug 1089277 has been marked as a duplicate of this bug. ***
This can be verified in the following locations: http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Administration_and_Configuration_Guide/index.html#sect-JMS_Bridges http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Migration_Guide/index.html#Create_a_JMS_Bridge
Sande, (not bug, but point for discussion) Do we want to have such a detailed description on setting a bridge on EAP5 in Administration Guide? I mean it's not really relevant to EAP6 administration and we already have it in Migration Guide. I would split whole "Procedure 18.1. Create a JMS Bridge" in chapter 18.8.2 into two: - First one with the current "Configure the Bridge on the Destination JBoss EAP 6 Server". Change the header to "Configure the Bridge deployed on JBoss EAP 6 Server" (dropping the word "destination", it's not needed here, since it shouldn't be about migration only). I also think we can drop "Since JBoss 6.1 and later,..." from the first paragraph (since it's documentation for 6.3 only). - Second one would be only part (d) from current "Configure the Bridge on the Source JBoss EAP 5.x Server", because that's basically the only relevant part for EAP6. Name it something like "JAR files you need for bridges deployed on other application servers".
Hi Martin, This topic is used in 2 guides. What I could do is add conditional logic so that the JBoss EAP 5 source bridge only appears in the Migration Guide and a generic "Configure your source" appears in the Administration Guide. Would that be better? Thanks, Sande
Sande, Sounds reasonable. Can you draft it on docbuilder so we can check how it looks like that? Thanks!
The Admin Guide version can be verified here: http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Administration_and_Configuration_Guide/index.html#Create_a_JMS_Bridge The Migration Guide version can be verified here: http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Migration_Guide/index.html#Create_a_JMS_Bridge
Thanks Sande