A guide on how to use... the guides!
mauromol Mar 16, 2009 6:56 AMHello,
I was trying to organize JBoss Transactions documentation in order to know what I should print and read... but I'm realizing it's a mess!
I mean, in jbossts-full-4.6.0.GA.zip I find a docs folder with:
- a JBoss Transactions 4.6.0 Installation Guide
- a JBoss Transactions 4.6.0 Administration Guide
- a JBoss Transactions 4.6.0 JTS Programmers Guide
- a JBoss Transactions 4.6.0 Quick Start Guide
- a JBoss Transactions 4.6.0 Transaction Core Programmers Guide
- a JBoss Transactions 4.6.0 Failure Recovery Guide
- a JBoss Transactions API 4.6.0 Programmers Guide
In jbossts-jta-4.6.0.GA.zip, instead, I find a docs folder with:
- a JBoss Transactions API 4.6.0 Installation Guide
- a JBoss Transactions API 4.6.0 Programmers Guide (same as above, I think)
- a JBoss Transactions API 4.6.0 Administration Guide
- a JBoss Transactions 4.6.0 Transaction Core Programmers Guide (same as above, I think)
- a JBoss Transactions 4.6.0 Failure Recovery Guide (same as above, I think)
The src packages (jbossts-full-4.6.0.GA-src.zip and jbossts-jta-4.6.0.GA-src.zip) seem to be quite more in order, because they distinguish between:
- ArjunaCore
- ArjunaJTA
- ArjunaJTS (only in jbossts-full package)
and all of them have their set of docs.
I also find that a lot of the documentation is replicated in many of the docs (for instance, the Administration Guides are very similar to each other, with little differences...), while the ArjunaCore 4.6.0 Administration Guide is not present in any of the bin packages. This is driving me crazy, so could you please help me to know what should I read?
In particular, my case is the following: I'm using jbossts-jta package to embed JBossTS into my web application. The transaction manager is configured and used through Spring. I need to start and stop the transaction manager and all the associated services (like the recovery manager) when the web application is started and stopped. I found that some documentation about this is in the ArjunaCore documentation, but it is not in the ArjunaJTA documentation.
My questions are:
- why ArjunaCore 4.6.0 Administration Guide is not in the binary package of jbossts-jta? There is some information I need there (on how to start and stop the transaction manager), which is not present in any of the other administration guides...
- which Administration Guide(s) should I read? And in which order?
- which Programmers Guide(s) should I read? And in which order?
I also find that there are some information that may not be up-to-date in the installation guides: for instance, I can't find the scripts to start the Transaction Manager as a service under Windows, mentioned in the Installation Guides (there are just those to start the Recovery Manager as a service).
Mauro.