Building Apache Geronimo with Maven 2

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.

Checkout Geronimo

$> svn co https://svn.apache.org/repos/asf/geronimo/trunk geronimo

To avoid failures during downloads from the ibiblio repository, it's advisable to define a mirror for the central m2 repository before running. Add the following lines to your ~/.m2/settings.xml

<?xml version="1.0"?>
<settings>
    <mirrors>
        <mirror>
            <id>repo.mergere.com</id>
            <url>http://repo.mergere.com/maven2</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
    </mirrors>
</settings>

Building for the first time

If you are building for the first time, a little patience is required.

$> cd geronimo
$> ./bootstrap

Warning

The bootstrap script will remove your local Maven2 repository cache and will take maybe 30 minutes or so to run... more or less depending on how fast your network connection is.

NOTE: Windows users need to run bootstrap from a Cygwin environment and should probably run these steps from the root of a drive (c:, d:, etc) to better ensure that the long filename problem is not an issue when testing.

After this you can build all the components any time using -

$> mvn clean install

Distribution binaries

The binaries for distribution can be found in the *.zip and *.tar.gz formats in following places

geronimo/m2-assembles/geronimo-jetty-j2ee/target
geronimo/m2-assembles/geronimo-tomcat-j2ee/target
geronimo/m2-assembles/geronimo-jetty-minimal/target
geronimo/m2-assembles/geronimo-tomcat-minimal/target

Pending Issues

There are still a few remaining issues which need to be sorted out.

Some use of version properties in pom.xml files are inconsistent due to selective use by child pom's that can not easily make use of the <dependencyManagement> section; which is the desired end result. It will take some time to refactor to get this really finished.

Some minor work is needed to get the jsp/servlet examples happy. Also need to resolve the geronimo-samples groupId (and more so where that source comes from).

https://issues.apache.org/jira/browse/GERONIMO-2206

Some (2 actually) test failures need to have some attention given to them, tracked be:

Some more work also needs to be done on the Maven-2 generated site, but there is most of it here already:

http://geronimo.apache.org/maven/

Other Useful commands

To prepare Geronimo for Eclipse, i.e to create .classpath and .project files

mvn -o eclipse:eclipse

Child pages