Bug 1086849

Summary: Add new section about CommitMarkableResources - new implementation of LRCO argorithm for databases
Product: [JBoss] JBoss Enterprise Application Platform 6 Reporter: Hayk Hovsepyan <hhovsepy>
Component: DocumentationAssignee: Nidhi <nchaudha>
Status: CLOSED CURRENTRELEASE QA Contact: Hayk Hovsepyan <hhovsepy>
Severity: urgent Docs Contact:
Priority: unspecified    
Version: 6.3.0CC: hhovsepy, nziakova, ochaloup, sgilda, tom.jenkinson
Target Milestone: ER4   
Target Release: EAP 6.3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: 1073834 Environment:
Build Name: 22508, Development Guide-6.3-1 Build Date: 06-03-2014 07:50:55 Topic ID: 4303-591659 [Latest]
Last Closed: 2014-06-28 15:37:49 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:
Bug Depends On: 1073834    
Bug Blocks:    

Description Hayk Hovsepyan 2014-04-11 16:30:18 UTC
Title: About the LRCO Optimization for Single-phase Commit (1PC)

In Section 10.3.2 it describes only old LRCO Optimization mechanism.
But it needs new section about Commit Markable Resource (new implementation of LRCO algorithm) algorithm description as well.


Original bug from which it is cloned is about adding new section about the same new CMR algorithm in Administration and Configuration Guide.

+++ This bug was initially created as a clone of Bug #1073834 +++

Hi,

in EAP 6.3.0 transaction team implemented new feature as documented here:
https://issues.jboss.org/browse/PRODMGT-49

It's new implementation of LRCO algorithm which makes non-xa resource fully recoverable (if it's database datasource and as it's just one in the XA transaction).

It's necessary to document this new feature. Good person to contact is Tom Jenkinson <tom.jenkinson>.

Please, then document that this new datasource needs to have new argument "connectable" set to true. It would be probably fine to add this thing under the section about configuraton of XA and non-XA datasources (like http://documentation-devel.engineering.redhat.com/site/documentation/en-US/JBoss_Enterprise_Application_Platform/6.3/html-single/Administration_and_Configuration_Guide/index.html#Configure_an_XA_Datasource)

Thank you
Ondra

Comment 7 Russell Dickenson 2014-04-22 01:49:18 UTC
Reassigned to Nidhi Chaudhary as Lucas is committed to other work at present.

Comment 9 Nidhi 2014-04-23 10:20:42 UTC
Added topic #30533 to Development Guide. Changes will be visible in the next build.

Comment 11 Nidhi 2014-04-28 03:16:54 UTC
*** Bug 1073834 has been marked as a duplicate of this bug. ***

Comment 12 tom.jenkinson 2014-04-29 12:51:21 UTC
The section on adding a CMR should mention that the setting will not take affect until the server is restarted - thanks.

Comment 13 Hayk Hovsepyan 2014-05-05 08:20:40 UTC
Checked in revision: 6.3.0-11.

Comment https://bugzilla.redhat.com/show_bug.cgi?id=1086849#c12 made by Tom was added after putting ON_QA, so they are not available. But still the info in this comment is important to be mentioned in documentation, so reopening the bug.

Comment 16 Nidhi 2014-05-07 16:41:00 UTC
Sande, thanks for reviewing the topic. :)

Comment 17 Nidhi 2014-05-07 16:43:21 UTC
Added the note about restarting the server. Changes will be visible in the next build.

Comment 19 Hayk Hovsepyan 2014-05-12 09:36:03 UTC
Verified on EAP-6.3.0.ER3-rebuild1