Bug 1122284

Summary: X-Site Replication Example From Admin Guide Does Not Work
Product: [JBoss] JBoss Data Grid 6 Reporter: John Osborne <josborne>
Component: DocumentationAssignee: Rakesh <rghatvis>
Status: CLOSED CURRENTRELEASE QA Contact:
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 6.2.1CC: jdg-bugs, mhusnain, rvansa
Target Milestone: Post GA   
Target Release: 6.3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2014-08-14 01:39:51 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:
Embargoed:
Attachments:
Description Flags
Working Cross Site Example none

Description John Osborne 2014-07-22 20:43:16 UTC
Created attachment 920046 [details]
Working Cross Site Example

Description of problem:
The Cross Site Replication (library mode) example from the JDG 6.2 Admin Guide, Chapter 27, does not work.

Version-Release number of selected component (if applicable):
6.2.1 GA

How reproducible:
Cut and paste XML from Chapter 27 for both caches.  Backup site will not receive data from primary site.

I am attaching my files for which I was able to get it to work.  I notice several differences in the working example.
- Backup site does not have <sites> element and sub elements <backupfor>
- Backup site cache has 
<transport>
<properties>
<property name="configurationFile" value="jgroups-relay-dc2.xml" />
</properties>
</transport>

Whereas the example in the admin guide does not have those tags.

- Backup site has a jgroups-withrelay.xml file

There could be other differences as well.  I am not sure which configuration change will cause the admin guide example to work as my VMs have been removed from SALABs.

Comment 3 Rakesh 2014-07-25 15:13:51 UTC
Radim, I added the transport elements. Please QA.

Comment 4 Radim Vansa 2014-07-25 15:43:15 UTC
I don't think this was a bug at all, rather misunderstanding the docs. The ellipsis in configuration excerpts were meant as a placeholder for the transport configuration.

Let's hope this way is it more clear to reader (though too verbose in my opinion).

Comment 5 John Osborne 2014-07-30 19:52:17 UTC
Thanks Radim.  I really appreciate the mod to the documentation.  A new user may not totally understand that the transport element needs to be configured.  The more that we can explicitly state then more valuable the doc is to the end users.

Comment 6 Misha H. Ali 2014-08-14 01:39:51 UTC
The fix for this bug is now available on access.redhat.com:

https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_Data_Grid/6.3/