THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
This is still a work in progress...
Prerequisites -
- J2SE SDK 1.4.2 (http://java.sun.com/j2se/1.4.2/
) - Apache Maven 2.0.4 (http://maven.apache.org)
- Subversion 1.2.0 (http://subversion.tigris.org/) - any version greater than 1.0 should work well.
To build the full server, you must use Maven 1 and follow these directions : http://wiki.apache.org/geronimo/Building
Important
It is not yet possible to build the full server using Maven 2
If you would like to build components of geronimo, follow the instructions below.
Checkout Geronimo
$> svn checkout http://svn.apache.org/repos/asf/geronimo/trunk geronimo
For the impatient ...
A little patience is required. If you are building for the first time -
Useful Information
The following steps are temporary..
1. Build xmlbeans-maven-plugin - why? see http://issues.apache.org/jira/browse/GERONIMO-2082
2. Build specs from the source at http://svn.apache.org/repos/asf/geronimo/specs/tags/1_1
3. Checkout openejb - svn checkout https://svn.codehaus.org/openejb/branches/v2_1/openejb2 openejb
complete steps 1, 2 and 3 described above
$> cd geronimo
$> mvn -N install
$> cd modules
$> mvn
$> cd ../m2-plugins
$> mvn
After this you can build all the components any time using -
$> mvn clean install
Building Geronimo -
Update the source using svn update
Once all the dependencies have been downloaded, Geronimo can be built offline.
$> mvn -o clean
$> mvn -o
important
The 'configs' must always be built using mvn clean install
Building all the projects at once -
The main project is divided into many groups, each group contains many individual projects. The groups are -- modules
- applications
- m2-plugins
- openejb (optional)
- configs
- assemblies
Geronimo build downloads all the necessary openejb jars. To build Geronimo without openejbSometimes the latest openejb jars are not available in the repositories. If you see any openejb related failures, you need to build openejb. To build geronimo and openejb together$> mvn clean install (coming soon..)
$>mvn -Dbuild-all clean install (coming soon..)
Building a single project
There are many ways to build a single project.From the top level or second level
To specify the name of a single project use any of the following properties :
mvn -Dmodule=kernel
mvn -Dapp=console
mvn -Dplugin=geronimo-packaging-plugin
mvn -Dconfig=j2ee-system clean install
mvn -Dejbmodule=openejb-coreFrom the individual project level
mvn or mvn clean install
Building a set of projects -
From the top level
To build a group project use the 'all' property -
mvn -Dall=modules | applications | m2-plugins | openejb | configs clean installFrom the second level
cd modules | applications | m2-plugins | openejb | configs
mvn or mvn clean install
Other Useful commands
To prepare Geronimo for Eclipse, i.e to create .classpath and .project files
mvn -o eclipse:eclipse