BUILDING.txt

Welcome to Geronimo
===================
 
To build me please install Maven from here - version 1.0.2 or later.

	http://maven.apache.org/

In addition you should have JDK 1.4.x installed with JAVA_HOME
environment defined to point to this JDK.

* NOTE * Currently Geronimo requires the Sun 1.4 JDK for building.  Newer JDK 
         Versions may not work.  Use at your own risk.

In the following examples, '$>' is your prompt, so if you see 
'$> maven', at your prompt, type in 'maven' (without the quotes) 
and then press [enter].

To build Geronimo running all of the unit test cases, compiling 
all the Geronimo sources and installing them in your local maven
repository, simply type "maven" in the root of the Geronimo
source tree:

        $> maven 

That command will run the default "new" target and compile 
Geronimo, using recent binary builds of OpenEJB and TranQL.  In 
some cases synchronized changes are made to several of the 
projects at once, and you may have trouble building the HEAD code 
of Geronimo against the older binaries of OpenEJB of TranQL.  
In that case, you can run:

	$> maven m:co
	$> maven m:clean m:clean-repo new

The first command checks out the latest OpenEJB and TranQL code,
while the second cleans and previous build output and rebuilds
Geronimo, OpenEJB, and TranQL from scratch.

To run the server, change into one of the assemblies directory
and start the server using a command like this:
	
        $> cd assemblies/j2ee-jetty-server
        $> cd target/geronimo-1.0
        $> java -jar bin/server.jar

To stop the server use ctrl-C or use the shutdown JAR.
(See http://wiki.apache.org/geronimo/Running for more information).

To do a clean rebuild of Geronimo type

        $> maven m:clean m:clean-repo new

To only build select modules (assumes that depends are installed
already):

        $> maven -Dmodules=common,core

To clean your workspace:
	
        $> maven clean

NOTE: You need to build the server first for this to work due to 
      a problem with dependencies & the reactor.

To removal all build generated files:

        $> maven clobber