git clone https://gitbox.apache.org/repos/asf/tomee.git tomee
We have moved to GIT. This means that anything you may find elsewhere on the site about SVN is no longer valid!
The documentation will be updated over the next few days and weeks but if you find anything that is really misleading then please send a message to the developer list at: firstname.lastname@example.org
Probably the best GIT tutorial on the planet can be found here: https://www.atlassian.com/git/ - This is a great reference for both existing and new GIT users. Please take a look.
GIT Information for Everyone
You can browse the source code via the web interface.
If you just want to build the source version then you can download (aka clone) the sources of Apache TomEE with a GIT client from the following URL https://gitbox.apache.org/repos/asf/tomee.git - The 'master' branch is the current development branch.
Performing the checkout from a command line using the GIT client (recommended) is as easy as executing the following command:
If you want to checkout a specific branch then you can just change that in the command:
git clone -b tomee-1.7.x https://gitbox.apache.org/repos/asf/tomee.git tomee-1.7.x
Or alternatively with Apache Maven 3.0.5 or later:
mvn scm:checkout -DconnectionUrl=scm:git:https://gitbox.apache.org/repos/asf/tomee.git -DcheckoutDirectory=tomee
|This method does not require the GIT client.|
GIT Information for TomEE Contributors
To build the code, you’ll need to grab a copy of Apache Maven, version 3.0.5 or later.
It is pretty much guaranteed that you will need to give Maven an increase on the available memory. + Depending on the OS you are working on the fix can be as easy as (Note: -XX:MaxPermSize=256M is ignored by Java 8):
export MAVEN_OPTS="-Xmx768m -XX:MaxPermSize=256M -XX:ReservedCodeCacheSize=64m -Xss2048k"
on MacOS and Unices or
set "MAVEN_OPTS=-Xmx768m -XX:MaxPermSize=256M -XX:ReservedCodeCacheSize=64m -Xss2048k"
on MS Windows.
A fast build that skips all tests, generates no reports and creates full distribution archives is as follows:
mvn -Dsurefire.useFile=false -DdisableXmlReport=true -DuniqueVersion=false -ff -Dassemble -DskipTests -DfailIfNoTests=false clean install
The full build with tests takes around 2 hours:
mvn -Dassemble clean install
The output of those commands should end with "BUILD SUCCESSFUL"
It is of course possible to just compile and test individual modules. Just change to the module directory and run the same commands as above.
If you are in real a hurry (and let’s face it most of us are) you can run a quick build without the examples using the quick profile:
mvn -Pquick -Dsurefire.useFile=false -DdisableXmlReport=true -DuniqueVersion=false -ff -Dassemble -DskipTests -DfailIfNoTests=false clean install
Once built, the TomEE binaries will be located at:
ls [project]/tomee/apache-tomee/target/*.zip tomee/apache-tomee/target/apache-tomee-jaxrs-[version]-SNAPSHOT.zip tomee/apache-tomee/target/apache-tomee-plus-[version]-SNAPSHOT.zip tomee/apache-tomee/target/apache-tomee-webprofile-[version]-SNAPSHOT.zip tomee/apache-tomee/target/apache-tomee-plume-[version]-SNAPSHOT.tar.gz
The OpenEJB standalone binaries will be located at:
ls [project]/assembly/openejb-standalone/target/*.zip assembly/openejb-standalone/target/apache-openejb-[version]-SNAPSHOT.zip