JBoss 3.0 Documentation - Non Existent?
lk575 May 3, 2002 11:04 AMHi,
We have been using JBoss 2.4.x for quite a while and I feel that I have pretty thorough understanding of its architecture and configuration. We got our application running on it and resolved most of the issues (other than known JBoss bugs). However, all of that was made possible mostly because we were able to find decent documentation for JBoss 2.4.x (including free html on-line documentation as well as other documentation that we purchased for $10).
Recently, we have decided to try out new JBoss 3.0. Obviously with all of its new features and improvements it looks very promising and tempting to upgrade to it. However, in my option there is no documentation available that describes the configuration of JBoss 3.0. How am I supposed to try it out then? When I downloaded jboss-3.0.0RC1.zip file there was no documentation in it whatsoever. It looks like JBoss.jcml is completely gone and configuration is completely different from JBoss 2.4.x (I guess mostly because everything is done through JCA now). There is a whole bunch of small XML configuration files but no description on what they are, what is the proper way to configure each of them and how do they work together to make JBoss 3.0 configuration complete.
It is very frustrating. I have tried to get documentation in several ways. For example, in some places on www.JBoss.org it is referred to the fact that if you get the whole jboss-all module from CVS and then rebuild it that will produce "build\output\docs" directory with all of the necessary documentation in it. I did exactly that but all I got is just a bunch of different sample xml data source configuration files for different databases. Obviously that is not enough.
I understand that JBoss 3.0 is not finally released yet but it is available for download in order to try it and test it and report the problems. Therefore there should be at least some documentation available so people can understand how to configure it - otherwise it is useless.
I do not mean to vent my frustration with this issue here but I just hope that this documentation exists and somebody will refer me to it. Again I am not looking for absolutely complete and perfect JBoss 3.0 documentation but I need something that will get me going with understanding and configuring JBoss 3.0. Thanks in advance.
lk575