...

The Geronimo Eclipse 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:

Getting the software

The Geronimo Eclipse Plugin (GEP) requires the following prerequisite software (all of which is platform specific):

...

The Geronimo server can be installed using the Geronimo Eclipse Plugin, or optionally you may install the manually. To install it manually, download the Geronimo 2.1.1 server from http://wwwgeronimo.apache.org/dist/geronimo/downloads.html 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 definitive and current version of the GEP installation instructions may be found here: How to install Geronimo Eclipse Plugin v2.1.

...

7.

...

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

...

...

If you choose to manually install the GEP first ensure that the Eclipse installation (that you plan to unzip into) does not already contain the GEP features and plugins. If it does, you must first manually uninstall them all. Otherwise, Eclipse will get confused with multiple versions of the same plugin(s) and feature(s), and you may not get the results that are expected (i.e., you may in fact end up using an older version of the GEP).

...

Verify GEP Installation

To verify that the GEP installation has been successful, start your new Eclipse installation and from the workspace select "Help --> About Eclipse Platform". In the panel that appears you will see anywhere from 4-6 Eclipse icons representing the various Eclipse projects and/or components installed. You must also see the Geronimo icon as shown below. If not something has not been installed correctly. If the Geronimo icon does appear that is a very good indication that Eclipse and the GEP have been installed correctly, and you can confidently continue to the next step.

...

1. 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.
2. Select Apache Geronimo v2.1 Server and click Next.
3. Select a 5.0 JRE (click Installed JREs to add any new JREs and return to this dialog once done).
4. 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. Skip the next three steps and go to selecting source archive.
5. Enter a directory for Application Server Installation Directory, under Download Options select the web container and click Download and Install. Notetitle Important

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

6. Click OK for Install Confirmation. This will install the selected Geronimo v2.1 server and fill the Application Server Installation Directory field accordingly.
7. Click Next.
8. Select the location of the archive containing Geronimo source and click Next. This is required only if you intend to debug into Geronimo source code.
9. Modify Hostname, Administrator Id, Administrator password, Web Connector port and RMI Naming port if necessary and click Finish. Normally you will not need to change the default values for these fields for a newly installed Geronimo 2.1 server.

...

1. Select File, Import to launch the Select dialog.
2. Based on your application type, select as given below:
   • For Web application, Select Web, WAR file.
   • For EAR application, Select J2EE, EAR file.
   • For EJB application, Select EJB, EJB JAR file.
3. Click Next. note

   Remaining steps are based on a web application.

4. Type the name of the WAR file or select the WAR file by clicking on Browse, enter/edit the Project Name and select Apache Geronimo v2.1 Runtime as Target Runtime.
5. Click Finish to complete the import.

...