You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 53 Next »

Prerequisites

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

Checkout Geronimo

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

Windows 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.

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>

Windows Tip

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

Building for the first time

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

External Dependencies

You will need Ant installed and available in the search path of your shell. You will also need the Subversion svn client installed and on your path.

cd server
./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.

If you do not want to loose your repository cache, then please run the steps one by one and skip the clean step (see below for more details).

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

mvn clean install

Chances are you will need to increase the heap size for Maven. Add the following lines to ~/.mavenrc:

# Increase the heap and max permission size for Maven
MAVEN_OPTS=-Xmx512m

If you are using the SUN JDK, you may also need to increase the maximum permanent size as well as the heap:

# Increase the heap and max permanent size for Maven
MAVEN_OPTS=-Xmx512m -XX:MaxPermSize=128m

Windows Tip

Windows users should create mavenrc_pre.bat under c:\documents and settings\<username>\mavenrc_pre.bat or c:\mavenrc_pre.bat depending on how the %HOME% property is set on your system.

Variables will need to use the batch set syntax:

set <VARIABLE>=<VALUE>

Bootstrap with out a full `bootstrap`

You can run the steps one by one (skipping steps as desired):

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

Or you can use the minimal bootstrap, which avoids a full repo cleaning and does not download and build any thirdparty sources:

./bootstrap minimal

Distribution binaries

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

  • server/assembles/geronimo-jetty-j2ee/target
  • server/assembles/geronimo-tomcat-j2ee/target
  • server/assembles/geronimo-jetty-minimal/target
  • server/assembles/geronimo-tomcat-minimal/target

Testing the assembly

To test an assembly, unpack and startup, as in:

gunzip -c assemblies/geronimo-jetty-j2ee/target/geronimo-jetty-j2ee*-bin.tar.gz | tar xf -
./geronimo-jetty-j2ee*/bin/startup.sh

And then shutdown:

./geronimo-jetty-j2ee*/bin/shutdown.sh

Or, use the geronimo-maven-plugin to start the server:

Required Maven Settings

In order to run with the simple geronimo prefix, you need to add a pluginGroup for org.apache.geronimo.plugins:

<?xml version="1.0"?>

<settings>
    <pluginGroups>
        <pluginGroup>org.apache.geronimo.plugins</pluginGroup>
    </pluginGroups>
</settings>

mvn geronimo:start

Windows Tip

Windows users may need to specify an alternative installDirectory to avoid long path problems:

mvn geronimo:start -DinstallDirectory=c:\g

And to stop:

mvn geronimo:stop

Other Useful commands

To prepare Geronimo for IDEA:

mvn idea:idea

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

mvn eclipse:eclipse

What is Genesis?

Please see Genesis Overview for more information about Genesis.

  • No labels