F I R S T   S T E P S :   B R I N G   J B O S S   T O   L I F E  

Make sure you install JBoss in a directory whose name doesn't contain space (avoid the 

 Program Files  directory).  Then to install JBoss all you need to do is unzip the binary.  

That's it.  Your installation is ready to go.  Note that JBoss comes with a default datasource 

configured for Hypersonic, so for the purposes of this Getting Started book you are ready to 

go and develop.  If you need to configure your own datasource there is a forum at 

http://www.jboss.org/forums/

 dedicated to the configuration of your different datasources. Check there 

to see if a particular database is posted there, it will save you some trouble. 

Source Code Download 

As mentioned above source can be downloaded from the JBoss download pages. When you 

like either to get the most accurate source or want to start coding in JBoss it is preferable to 

download the source from CVS repository.  

Here is a checklist how to download JBoss from CVS:  

Check if you have a CVS client available (CVS, jCVS, WinCVS). If not then download 

and install either it either from www.cvs.org, www.jcvs.org, or www.wincvs.org. 

Another way for Windows users is to download and install Cygwin 

(http://sources.redhat.com/cygwin) a Unix emulator. You can do so by downloading 

and starting the Cygwin Installer. Now check that CVS and VI or VIM is selected and 

start the installation. After the installation is finished you can open a "bash" shell 

with most Unix commands available (inclusive CVS). Now you can work in this shell 

nearly as if you were working on a Unix box. Noteworthy is that you can also run 

windows scripts (*.bat) in this shell as well.  

For CVS clients without developer access type: 

cvs  d:pserver:anonymous@cvs.jboss.sourceforge.net:/cvsroot/jboss login  

cvs  z3  d:pserver:anonymous@cvs.jboss.sourceforge.net:/cvsroot/jboss co jboss all  

For jCVS or WinCVS clients set CVS Server to "cvs.jboss.sourceforge.net", select 

server type as "PServer", set CVS Repository to "/cvsroot/jboss" and user name to 

"anonymous" with empty password. Then checkout the CVS Module "jboss all".  

After you have checked out the "jboss all" module the next time you want to update 

the source code just go in the root directory (/jboss all) and perform an update with:  

cvs  z3  d:pserver:anonymous@cvs.jboss.sourceforge.net:/cvsroot/jboss update  dP 

or with the appropriate commands in jCVS or WinCVS. This will update your source with 

the current in the CVS repository. At the end please check that you do not have a conflict on 

16