[jboss-jira] [JBoss JIRA] Commented: (JBAS-6244) document how to properly configure resource recovery in jbossjta-properties.xml

[John Mazzitelli (JIRA)]

    [ https://jira.jboss.org/browse/JBAS-6244?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12559955#action_12559955 ] 

John Mazzitelli commented on JBAS-6244:
---------------------------------------

>This belongs in the Development Guides for the Arjuna projects. 

I  disagree with that. That was part of my problem all along - some of this info was already in Arjuna (though not everything) but there are two problems with that:

1) I wasn't using Arjuna specifically, I was using JBossAS and thus I was not expecting to go to a completely separate product's documentation to get the answers I needed (yes, Arjuna is under the covers to provide the transaction manager but I was configuring JBossAS config files). I was expecting to see JBossAS configuration help in the JBossAS docs. We should not expect users of JBossAS to even understand that Arjuna is the product inside of JBossAS - we should therefore not expect them to know that they have to go to Arjuna documentation to configuration JBossAS transactioning.

2) The information I needed was JBossAS specific.  The Arjuna docs had some information, but it was explicitly dealing with Arjuna-standalone configuration - it didn't have all the information related to its integration with JBossAS. And I'm not even sure if the Arjuna team wants their documentation to have JBossAS specific documentation in it.

Therefore, because of the above, we should add this documentation specifically to the JBossAS documentation. Its where JBossAS users are going to go in order to get help for JBossAS configuration.

> document how to properly configure resource recovery in jbossjta-properties.xml
> -------------------------------------------------------------------------------
>
>                 Key: JBAS-6244
>                 URL: https://jira.jboss.org/browse/JBAS-6244
>             Project: JBoss Application Server
>          Issue Type: Task
>      Security Level: Public(Everyone can see) 
>          Components: Docs/Administration and Configuration Guide
>    Affects Versions: JBossAS-4.2.1.GA
>            Reporter: John Mazzitelli
>            Assignee: Misty Stanley-Jones
>
> Currently, people are having a tough time figuring out how to correct this error when their apps hit it while running inside of JBossAS:
> 21:31:10,147 WARN  oggerI18N om.arjuna.ats.internal.jta.resources.arjunacore.norecoveryxa om.arjuna.ats.internal.jta.resources.arjunacore.norecoveryxa Could not find new XAResource to use for recovering non-serializable XAResource 
> For examples of the types of questions people are asking (yes, I was one of them :):
> http://www.jboss.com/index.html?module=bb&op=viewtopic&t=146138&start=0&postdays=postDays&postorder=postOrder&highlight=highlight
> http://saloon.javaranch.com/cgi-bin/ubb/ultimatebb.cgi?ubb=get_topic&f=78&t=004053
> http://www.nabble.com/JBoss-Integration---recovering-XAResource-td20035573.html
> http://forums.java.net/jive/thread.jspa?messageID=254647
> This talks about the problem, but nothing specifically addresses how to actually fix the problem: http://www.jboss.org/community/docs/DOC-12463
> This comes close - but it mentions Messaging specific things, so it is not clear how you do this for your own JDBC data sources: https://www.jboss.org/community/docs/DOC-12826
> This JIRA is to request that our documentation specifically address this problem and provide explicit hints as to how to fix it.  Mention things like:
> 1) the existance of the Oracle and generic JNDI recovery modules, but how they are not configured/activated out-of-box
> 2) how to edit jbossjta-properties.xml to configure those  modules with the JDBC URL/JNDI URI and db user/pass
> 3) how to add the recovery modules in jbossjta-properties.xml
> I talk about how I plan to solve this in that first forum post linked above - that could be used as an example for the kind of docs I was looking for. Even if all this JIRA does is add a commented section in jbossjta-properties.xml, that would go a long way in helping solve this problem for people without them resulting to hair pulling or jumping off bridges.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: https://jira.jboss.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira