...

The Geronimo Eclipse Plugin (GEP) requires the following prerequisite software (Note: Update the list once GEP 2.1 is released).all of which is platform specific):

• Sun JDK 5.0 (J2SE 5.0)
• Eclipse 3.3.1.1 (Eclipse Classic package of Europa distribution), which is platform specific
• Web Tools Platform (WTP) 2.0.1
• Data Tools Platform (DTP) 1.5.1
• Eclipse Modeling Framework (EMF) 2.3.1
• Graphical Editing Framework (GEF) 3.3.1
• IDE for Java EE Developers

Sun JDK 5.0 can be downloaded from Sun's J2SE 5.0 Downloads site. WTP and all the other prerequisites The Eclipse IDE for Java EE Developers can be downloaded from WTP Downloads site.the Eclipse Downloads site. Download and extract the Eclipse IDE for Java EE Developers archives to a directory of your choice (for e.g. C:\eclipse). The archive will be extracted to a directory named eclipse under the directory you specified (for e.g. C:\eclipse\eclipse), referred to as <eclipse_home> from now on. Make sure that the JDK in the PATH is Sun JDK 5.0. Launch Eclipse by running <eclipse_home>/eclipse.

The Geronimo server can be installed from within using the Geronimo Eclipse Plugin. This feature does not work currently for , or optionally you may install the manually. To install it manually, download the Geronimo 2.1 server. Download Geronimo 2.1 server from http://www.apache.org/dist/geronimo/ and extract the archive to a directory of your choice (for e.g. C:\g). The archive will be extracted to a directory geronimo-tomcat6-javaee5-2.1.1 (for e.g. C:\g\geronimo-tomcat6-javaee5-2.1.1) or geronimo-jetty6-javaee5-2.1.1 depending on whether you downloaded Geronimo 2.1.1 distribution with Tomcat or Jetty as the web container. We will refer to this directory as <geronimo_home> from now on.

...

The JBoss to Geronimo Migration Tool (J2G) is an Eclipse plugin designed to assist in migrating the sources of an application written for the JBoss application server or written for Java Enterprise Edition (Java EE) to the Apache Geronimo platform. For more information on using the J2G tool follow this link. (Note: Need to link to the J2G usage page)

Maven Integration for Eclipse

...

For more details and installation instructions, visit http://m2eclipse.codehaus.org/.

Installing Eclipse

The prerequisite software for GEP can be downloaded either as a single download or individual downloads. In this section we discuss the various options available to install the prerequisite software.

WTP All-in-One package

WTP along with all the other prerequisites can be downloaded in one combined bundle from WTP Downloads site. Download WTP All-In-One Package specific to your platform from v2.0.1 of WTP. Extract the archive to a directory of your choice (for e.g. C:\wtp). The archive will be extracted to a directory named eclipse under the directory you specified (for e.g. C:\wtp\eclipse), referred to as <eclipse_home> from now on. This completes the installation of eclipse.

Eclipse and WTP downloaded separately

Alternatively you can download Eclipse and WTP separately and install the prerequisites using the following steps:

1. Download Eclipse 3.3.1.1 from http://www.eclipse.org/downloads/.
2. Extract the archive to a directory of your choice (for e.g. C:\wtp). The archive will be extracted to a directory named eclipse under the directory you specified (for e.g. C:\wtp\eclipse), referred to as <eclipse_home> from now on.
3. In WTP Downloads site, follow the link corresponding to v2.0.1 of WTP.
4. Download each of the prerequisites DTP, EMF and GEF and extract the archives to <eclipse_home>.
5. Download the wtp-sdk package listed under Web Tools Platform Complete and extract the archive to <eclipse_home>

Launch Eclipse by running <eclipse_home>/eclipse. Make sure that the JDK in the PATH is Sun JDK 5.0.

Installing Geronimo Eclipse Plugin

The Geronimo Eclipse Plugin (GEP) can be installed using the following options:

1. Using WTP
2. Using Eclipse Update Manager
3. Manual Installation

#1. Install GEP Using WTP

The GEP can be installed directly from within WTP while defining a server runtime. Follow the steps below to install GEP:

...

#2. Install GEP Using Eclipse Update Manager

The GEP can also be installed via the Eclipse Update manager by creating a new remote site pointing to http://www.apache.org/dist/geronimo/eclipse/updates/. Follow the steps below to install GEP:

...

(Note: Add more instructions once GEP for 2.1 is released. Currently the Geronimo Eclipse Update site does not host GEP v2.1)

#3. Manual Installation of GEP

Download the GEP 2.1 from http://www.apache.org/dist/geronimo/eclipse/. Close Eclipse if it is already running. Extract the archive to <eclipse_home>. Launch Eclipse by running <eclipse_home>/eclipse.See How to install Geronimo Eclipse Plugin v2.1.2

Geronimo Server Runtimes and Servers

...

1. Click Window -> Preferences -> Server -> Installed Runtimes.
   
   
   
   
2. Click Add to launch New Server Runtime dialog.
3. Select Apache Geronimo v2.1 Runtime, uncheck Also create new local server (we will discuss about the use of this option later) and click Next.
   
   
   
   
4. Select Workbench default JRE (click Installed JREs to add any new JREs and return to this dialog once done).
5. If you already have Geronimo v2.1 installation that you want to use with GEP, enter the directory name or browse to <geronimo_home> and click Next. (Note: Download options part of this dialog does not work currently.) . Skip the next three steps and go to selecting source archive.
6. Enter a directory for Application Server Installation Directory, under Download Options select the web container and click Download and Install.
   
   Image Added
   
   

   Note
   title Important
   The directory specified for Application Server Installation Directory must exist in order to select Download Options.

7. Click OK for Install Confirmation. This will install the selected Geronimo v2.1 server and fill the Application Server Installation Directory field accordingly.
8. Click Next.
   
   Image Added
   Image Removed
   
   
9. Select the location of the archive containing Geronimo source. This is required only if you intend to debug into Geronimo source code.
10. Click Finish to return to Installed Server Runtime Environments dialog.
    
    
    
    

...