{scrollbar}

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 Quick start guide for developers is organized in the following sections:

...

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

• Sun JDK 5.0 (J2SE Java Runtime Environment (JRE) 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

Sun JDK 5.0 Java Runtime Environment can be downloaded from http://java.sun.com/javase/downloads/index_jdk5.jsp. Eclipse and WTP Sun's J2SE 5.0 Downloads site. WTP along with all the other prerequisites can be downloaded in one combined bundle from http://people.apache.org/dist/geronimo/eclipse/unstable/ECLIPSE_AND_WTP.zip (Note: Update the URL once GEP 2.1 is released and prereqs are defined.) Download and extract WTP Downloads site. Download Web Tools Platform 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:). The archive will be extracted to a directory named eclipse under the directory you specified (for e.g. C:\eclipse), referred to as <eclipse_home> from now on. Make sure that the JRE JDK in the path PATH is a Sun JDK 5.0 JRE. Launch Eclipse by running eclipse.exe on Windows (for example c:\eclipse\eclipse.exe) and ??? on Linux. <eclipse_home>/eclipse.

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 (See Figure 1).
   • From any Perspective: Select File, New, Other, Server
     Image Removed
3. Click on the Download additional server adapters link (See Figure 2).
   Image Removed
4. In the Install New Server Adapter dialog, select Geronimo v2.1 Server Adapter and click Next. (See Figure 3. Note: Needs to be updated once GEP 2.1 is released).
   Image Removed
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 (See Figure 4).

#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 (See Figure 5).
     Image Removed
3. Create a Eclipse Remote Update Site as follows:
   • Click the New Remote Site... button (See Figure 6).
     
   • 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.
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://peoplewww.apache.org/dist/geronimo/eclipse/unstable/geronimo-eclipse-plugin-2.1.0-SNAPSHOT-deployable.zip and unzip it into the same directory where all the prereqs are installed (e.g., c:\eclipse). Restart eclipse once done.(Note: Update the download link once GEP 2.1 is released). Close Eclipse if it is already running. Extract the archive to <eclipse_home>. Launch Eclipse by running <eclipse_home>/eclipse.

Defining a New Server Runtime

...