Versions Compared

Old Version 64

changes.mady.by.user Jay McHugh

Saved on

compared with

New Version 65

changes.mady.by.user Anita Kulshreshtha

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content

Table of Contents

Prerequisites

Section
Column
Column
Note

Unless otherwise mentioned, You must use J2SE 1.4.x... NOT 1.5. The build should fail early if you are using the wrong JDK.

...

Tip
titleWindows Tip

Windows users are strongly encouraged to checkout Geronimo into c:\g.

Using a longer path may cause the build (and Geronimo itself) to behave very strangely when it hits the 260 char limit for filenames on Windows.


Advanced users may proceed to instructions for the advanced users

Preparing to build for the first time

...

  1. bootstrap clean
  2. bootstrap specs
  3. bootstrap modules
  4. bootstrap openejb2
  5. bootstrap assemble
    Note

    for bootstrap specs you need Java 1.5.

Distribution binaries

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

...

Note

In order to run with the simple geronimo prefix, you need to add a pluginGroup for org.apache.geronimo.plugins to your ~/.m2/settings.xml:

Code Block
xml
xml
<?xml version="1.0"?>
<settings>
    <pluginGroups>
        <pluginGroup>org.apache.geronimo.plugins</pluginGroup>
    </pluginGroups>
</settings>
Tip
titleWindows Tip

Windows users will find ~/.m2/ under c:\documents and settings\<username>\.m2.

If you don't want to add this to your local settings you can still enable the tools profile, which will register the prefixes.

For the Advanced Users
Anchor
advanced
advanced

Installing Ant is not necessary. Checkout specs and openejb2 using

No Format

svn co http://svn.apache.org/repos/asf/geronimo/specs/trunk specs
svn co https://svn.apache.org/repos/asf/incubator/openejb/trunk/openejb2 openejb2

Building specs

If you do not care about JEE 1.5 comment out the following lines in specs/pom.xml -

<!-- <module>geronimo-annotation_1.0_spec</module> -->
<!-- <module>geronimo-ejb_3.0_spec</module> -->
<!-- <module>geronimo-interceptor_3.0_spec</module> -->
<!-- <module>geronimo-jpa_3.0_spec</module> -->
<!-- <module>geronimo-jta_1.1_spec</module> -->
If you want to build the full specs you must use jdk 1.5. Build specs using

No Format

cd specs
mvn clean install

Building Geronimo with openejb2

Add a profile to the top level pom.xml like this

Code Block
xml
xml

        <profile>
            <id>build-all</id>

            <activation>
                <property>
                    <name>all</name>
                </property>
            </activation>

            <modules>
                <module>testsupport</module>
                <module>modules</module>
                <module>maven-plugins</module>
                <module>applications</module>
                <module>openejb2</module>
                <module>configs</module>
                <module>assemblies</module>
            </modules>
        </profile>

Build geronimo and openejb2 from the top directory using

No Format
 
mvn -Dall clean install or mvn -Dall

Other Useful commands

To prepare Geronimo for IDEA:

No Format

mvn idea:idea

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

No Format

mvn eclipse:eclipse

What is Genesis?

Please see Genesis Overview for more information about Genesis.