The Geronimo provides tooling for Eclipse and enables developers using Eclipse to use a Geronimo server to run the Java EE applications being developedEclipse Plugin (GEP) provides integration between Geronimo and the Web Tools Platform (WTP). With this plugin, users will be able to use the features in WTP to create, deploy and debug applications on Geronimo. This article helps with setting up a development environment using Geronimo Eclipse Plugin ( GEP).

Options and tools

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

• Java Runtime Environment (JRE) 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.1
• Data Tools Platform (DTP) 1.5.1
• Eclipse Modeling Framework (EMF) 2.3.1
• Graphical Editing Framework (GEF) 3.3.1

Sun JDK 5.0 can be downloaded from Sun's J2SE 5.0 Downloads site. WTP along with all the other prerequisites Java Runtime Environment can be downloaded from http://java.sun.com/javase/downloads/index_jdk5.jsp. Eclipse and WTP can be downloaded in one combined bundle , referred to as from WTP Downloads site.

Installing Eclipse

WTP All-in-One package

...

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://

...

1. www.eclipse.org

...

1. /downloads

...

1. /

...

1. .
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:

1. Launch Eclipse by running <eclipse_home>/eclipse.
2. Launch the Define a New Server dialog using one of the following:
   • From the Servers view in the Java EE Perspective: Right-click, New, Server.
   • From any Perspective: Select File, New, Other, Server
     Image Added
3. Click on the Download additional server adapters link.
   Image Added
4. In the Install New Server Adapter dialog, select Geronimo v2.1 Server Adapter and click Next.
5. Read and accept any License Agreements and click Finish. Click OK to continue installation.

This will download and install the GEP. The Progress view will display the installation status. Once the installation is completed, restart Eclipse. Define a New Server dialog will now show an Apache Geronimo v2.1 Server option under Apache.
Image Added

#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:

1. Launch Eclipse by running <eclipse_home>/eclipse.
2. Open the Eclipse Update Manager as follows:
   • Select Help, Software Updates, Find and Install.
   • Select Search for new features to install and click Next.
     Image Added
3. Create a Eclipse Remote Update Site as follows:
   • Click the New Remote Site... button.
   • Type Geronimo Eclipse Update Site (or other suitable unique name) in the Name field.
   • Type the URL of the Geronimo Eclipse Update site http://www.apache.org/dist/geronimo/eclipse/updates/ in the URL field.
   • Click OK.
     Image Added
4. Select only the Geronimo Eclipse Update Site in the Sites to include in search selection box and click Finish.
5. Select a mirror and click OK if prompted to do so.

(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/^{Image Added}. Close Eclipse if it is already running. Extract the archive to <eclipse_home>. Launch Eclipse by running <eclipse_home>/eclipse.

...

Installing Eclipse

Download the Eclipse and WTP or WTP All-in-One package suitable for you OS.

WTP All-in-One package

If you have downloaded WTP All-in-One package, extract the archive to a directory of your choice (for e.g. on Windows to C:\eclipse). 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:
Need details on the steps

...

Defining Servers

Creating a new project

...