Hide Forgot
Title: Configure the Transaction Manager Describe the issue: In Table 18.1. TM Configuration Options, The description of Relative to is wrong. It says "Use an empty string to disable the default behavior and force the value of the path attribute to be treated as an absolute path." but this sentence is wrong. If the attribute of relative-to sets empty string, it will be error with following message. [standalone@localhost:9999 /] /subsystem=transactions/:write-attribute(name=relative-to,value="") { "outcome" => "failed", "failure-description" => "JBAS014704: '' is an invalid value for parameter relative-to. Values must have a minimum length of 1 characters", "rolled-back" => true } Suggestions for improvement: * current Use an empty string to disable the default behavior and force the value of the path attribute to be treated as an absolute path. * tobe (The sentence should be deleted.)
The description of object-store-relative-to is wrong too. [standalone@localhost:9999 /] /subsystem=transactions/:write-attribute(name=object-store-relative-to,value="") { "outcome" => "failed", "failure-description" => "JBAS014704: '' is an invalid value for parameter object-store-relative-to. Values must have a minimum length of 1 characters", "rolled-back" => true } The documentations should be correct.
Tom, jlivings said you might be able to help out on this: Could you please confirm that the above is the intended behaviour? It looks like a null value might be accepted rather than an empty string, so should the docs be changed to reflect that, or should those sentences be removed as suggested by Kenjiro? Thanks
relative-to looks like it was added to be consistent with other services in the application server. If that feature is now solely present in transactions I would be happy to remove the feature from the subsystem entirely. Put another way, relative-to is not used by the transaction manager itself, it is purely to be consistent with setting file paths in WildFly/AS7 configurations and the behaviour should be the same as any other file path setting mechanism in the As.
Thanks Tom. After looking at the 'relative-to' uses throughout other services, there is no mention of an empty string being acceptable, so it looks like the best approach would be to remove the "empty string" sentence as suggested by Kenjiro. Changes made to topic 4310, rev 578952 The changes will be reflected in the next document build, and the status will be changed to ON_QA when it is ready for review.
Ready for review (Revision 6.3.0-1): 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_the_Transaction_Manager1
Verified. The incorrect point about relative-to is removed.
Thanks! Closed.