{scrollbar}

To build the Geronimo Eclipse Plugin (GEP) from source you need to have the following prerequisites installed.

• Apache Maven 2.0.9+
• Subversion 1.4.6+
• Sun JDK 5.0+ downloads or Sun JDK 6.0+ downloads
• Add the bin directories of maven and subversion to system variable Path.

  Info
  title Useful Information
  You can also change the default location of m2repo by modifying <MAVEN_HOME>/conf/settings.xml and modify the following tag <localRepository>C:\m2repo</localRepository>

  Table of Contents

  Getting the source code

1. Create a directory gep in the root location.

   Info
   title Useful Information
   It is strongly recommended that you use a small directory name for the source code download. At times there have been issues due to long path.

2. Open a command prompt and change gep directory created before. Run the following command to start downloading the source.

   No Format
   svn co http://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/trunk trunk

   
   
   
   
3. Subversion will start downloading the source and the command window will show the progress information.
   
   
   
   
   
   
4. On successful download you can see the revision number for the downloaded source.
   
   
   
   
   
   

Building Source

1. Modify heap settings for JVM as follows.

   Note
   The following environment variable needs be set to properly configure the JVM to meet memory requirements. MAVEN_OPTS="-Xms512m -Xmx512m -XX:MaxPermSize=256m" On Windows use the following command to set the environment variable (note that double quotes should not be used): set MAVEN_OPTS=-Xmx512m -XX:MaxPermSize=128m

2. Change to the trunk directory of the source you have downloaded and run the following command

   Code Block
   mvn clean install -Ptestsuite

   
   
   
   
3. Once done various dependencies will be downloaded to your m2 repository. If you are building GEP for the first time it may take considerable time.
   
   
   
   
4. On the success of build you can see a Build Successful message on the command prompt.
   
   
   
   
   
   

   Info
   You do not need to manually download Eclipse or the web tools project to build. This is taken care of for you automatically during the build process. You can find the downloads at <Local_M2_Repo>\eclipse-downloads

   Other Maven options

   Skip Test

   At times your build may fail due to test case failure. You can skip the test by running the following command

   No Format
   mvn clean -Dmaven.test.skip=true -Dmaven.itest.skip=true install

   Warning
   Skipping tests is not recommended