Geronimo Eclipse Plugin Installation Instructions

Installation Options:

#1. Install Geronimo Eclipse Plugin Using WTP

There a several installation alternatives, but the easiest method is not to download the plugin at all !! It can be installed directly from within WTP by clicking on the Download additional server adapters (shown below) link when defining a server runtime in WTP. Select it, then select Geronimo 2.0.1 and the installation process will begin. To display the New Server Runtime dialog you can do 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
  
  

Once the workbench restarts Geronimo 2.0.1 support will be available as shown:

#2. Install Geronimo Eclipse Plugin Using Eclipse Update Manager

Alternatively, the plugin can be also be installed via the update manager by creating a new remote site pointing to http://www.apache.org/dist/geronimo/eclipse/updates/. Here are the instructions:

1. Open the Eclipse Update Manager as follows:
   • Select Help, Software Updates, Find and Install....
   • Select Search for new features to install and click Next
     
     
2. Create a Eclipse Remote Update Site as follows:
   • Click the New Remote Site... button in the upper right corner
   • 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
     
     
3. Select only the Geronimo Eclipse Update Site in the Sites to include in search selection box and click Finish
   
   
4. Select a mirror and click OK if prompted to do so
   
   
5. Expand Geronimo Eclipse Update Site, and WTP Server Adapters
   
   
6. Install the desired WTP server adapters:
   • To install the Eclipse WTP server adapter for version 2.0.1 of the Geronimo server, select these WTP Server Adapters:
     • Geronimo Core Feature 2.0.0
     • Geronimo v2.0 Server Adapter 2.0.0
   • To additionally install the Eclipse WTP server adapter for version 1.1.0.x of the Geronimo server, also select:
     • Geronimo v1.1.x Server Adapter 2.0.0
   • It is not necessary or recommended to install a server for development and test from the Geronimo Runtimes in the update manager list at this time. The appropriate server will be downloaded the first time you click the Download and install button when you define a new server.
     
     
7. Click Next
   
   
8. Accept the license agreement and click Next
   
   
9. Click Finish
   
   
10. Click Yes to restart Eclipse for the changes to take effect
    
    
    

#3. Manually Install Geronimo Eclipse Plugin

Download the plugin from http://www.apache.org/dist/geronimo/eclipse/2.0.0/ and unzip it into the same directory where all the prereqs are installed (e.g., /eclipse). If you choose this option you must have an installed version of the Geronimo 2.0.1 server somewhere on your system so that you can define a new Geronimo Server configuration.

Tip After installing the Geronimo Eclipse Plugin, whether it is the first installation or a subsequent installation of a newer version, start Eclipse with the -clean option. This allows Eclipse to recognize and use the newest version of the WTP server adapter.