Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

90 lines (61 sloc) 2.802 kB
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License. You may obtain a copy of the License at
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# See the License for the specific language governing permissions and
# limitations under the License.
Welcome to Apache Geronimo
To build you will need:
* JDK 6.0+ (J2SE 1.6.0+) (
* Maven 3.0.3+ (
For detailed instructions please see:
Building Geroniomo
To build all changes incrementally:
mvn install
To perform clean builds, which are sometimes needed after some changes to the
source tree:
mvn clean install
Building with Java 7 on Mac OS
There is an issue building Geronimo on Mac OS due to the following problem
with the Maven JSPC Plugin:
You can work around this problem with the following:
$ sudo mkdir `/usr/libexec/java_home`/Classes
$ sudo ln -s `/usr/libexec/java_home`/lib/tools.jar `/usr/libexec/java_home`/Classes/classes.jar
Note that these commands will needed to be repeated when new versions
of the JDK are installed.
Testing the Build
The end result of a successful build will be a set of functional distributions.
To test the build, simply start the server:
1. Start the server manually
2. cd $GERONIMO_HOME/testsuite
3. mvn clean install -Dit
Generating a Site
There are several really annoying bugs in the site builds, mostly due to the
To build the site you need to first, build as in:
mvn clean install
And then:
mvn site -Denv=site
If you attempt to run `mvn clean install site` strange errors are bound to occur
which will drive you crazy and you may start pulling your hairout... so its not
It is important to specify `-Denv=site` to limit the modules which are processed,
as many of the configs modules will freak-out.
Jump to Line
Something went wrong with that request. Please try again.