Red Hat Bugzilla – Bug 1019090
Clarify description of the some properties in the table
Last modified: 2015-04-17 01:55:10 EDT
Title: Configure the Transaction Manager
There are two properties that I would ask for being change. I've consulted their functionality with developers and they are:
- Enable TSM Status "Whether to enable the transaction status manager (TSM) service, which is used for out-of-process recovery." - please add a note that 'we do not support running an out of process recovery manager so the ASS is just contacted in memory'
- Path "The relative or absolute filesystem path where the transaction manager core stores data." - please add info that this path is used for saving the process ID in it when <process-id> tag (process-id-uuid cli attribute) is used.
we found out one more error in the documentation of paths. There is error in description of item 'Object Store Path Relative To' where is said:
"The value of the path TM attribute is relative to this path."
The correct sentence should be
"The value of the object store path TM attribute is relative to this path."
Sorry for misguiding info. The whole context of the description on description of running recovery manager out of process should be:
The TSM service basically exposes one of these as a network endpoint: https://github.com/jbosstm/narayana/blob/master/ArjunaCore/arjuna/classes/com/arjuna/ats/arjuna/recovery/ActionStatusService.java
For EAP it is not required as we do not support running an out of process recovery manager so the ASS is just contacted in memory.
Moving to ON_QA.
The changes should be available for review on the documentation stage within an hour or so from this comment.
I'm returning this bug back as I do not agree with removing information about the enable-tsm-status.
I've checked the other two points that this issue refers to (with Path and Object Store Path Relative To) and they were fixed correctly.
Back to the enable tsm status. This attribute is not supported but it's still present in the CLI and in the XML config (namely could be seen in XSD) and user is able to set it. From my point of view it is appropriate to mention it in the documentation.
The info which is in the documentation for 6.2 is fine
just please add to the description that support running an out of process recovery and that by default is the TSM contacted in memory.
Related to https://bugzilla.redhat.com/show_bug.cgi?id=1034600
Taking this bug as I'm already working on 1034600
I reinstated the two options mentioned in 1034600, stating that both are unsupported.
I added a sentence to explain that the TSM status, while present, is not needed in EAP as the recovery manager is always run in a process.
The changes will be available for review in the next build of the docs suite.
thanks for you changes just don't you mind my asking for a small fix in the current text?
Whether to enable the transaction status manager (TSM) service, which is used for out-of-process recovery. Running an out of process recovery manager to contact the ActionStatusService in memory is not supported.
To something like:
Whether to enable the transaction status manager (TSM) service, which is used for out-of-process recovery. Running an out of process recovery manager to contact the ActionStatusService from different process is not supported (normally is contacted in memory).
Thanks a lot
I've made that change Ondrej. No problem.
The change will be visible in the next update to stage (I'll comment here when it's available)
Verified on A&C guide Revision 6.4.0-15 and Dev guide Revision 6.4.0-9