...

We will be using Eclipse Helios and Sun JDK 6.0+ for the illustration. Geronimo Eclipse Plugin (GEP) can be installed using the following options:

...

This page describes how to install the current release of the GEP. For information about installing previous releases, see

...

...

or this page for other releases.

...

Note that with v2.1.

...

7, the v2.1 Geronimo server adapter feature provides server adapters for both the v2.0.x and v2.1.x Geronino servers. Previously, v2.0.x and v2.1.x server adapaters were provided by separate features. Partly to simplify things, these features were combined into one.

Prerequisites Anchor PrereqsPrereqs

• JDK Java J2SE 1.6.0 or greater

...

• Eclipse IDE for Java EE Developers (Helios (Eclipse 3.6), Galileo (Eclipse 3.5) or Ganymede (Eclipse 3.4))
  Eclipse Galileo Download
  • Eclipse Ganymede DownloadEclipse Helios Download

• Apache Geronimo 2.0.x,  2.1.x server
  • Apache Geronimo downloads

See PLUGIN_RELEASE-NOTES-2.1.5.txt for additional details.

Installing GEP within WTP

...

• • Download

...

...

...

...

• Java J2SE 1.5.0 or greater

• Eclipse IDE for Java EE Developers (Galileo (Eclipse 3.5) or Ganymede (Eclipse 3.4))
  • Eclipse Galileo Download
  • Eclipse Ganymede Download

• Apache Geronimo 2.0.x,  2.1.x server
  • Apache Geronimo downloads

See PLUGIN_RELEASE-NOTES-2.1.57.txt for additional details.

Installing GEP within WTP

1. Once you have all the #Prerequisites installed, launch Eclipse from <Eclipse_Home>/eclipse.
2. By default Eclipse will be launched with Java EE perspective.
3. Select the servers tab as shown in the figure and select New->Server.
   
   
   Image Modified
   
   
4. On the next screen select Download Additional Server Adapters as shown in the figure.
   
   
   Image Modified
   
   
5. Select Geronimo V2.1 Server Adapter v2.1.5 7 adapter and select Next.
   Image Modified
   
   
   
6. Accept the license agreement and select Finish.
   
   Image Modified
   
   
7. Next screen will ask for confirmation. Select Ok OK. Once done Geronimo V2.1.5 7 server adapter will be downloaded and installed.
   
   Image Modified
   
   
8. During the installation, a Selection Needed window will pop up. Click the box of the certification that you trust and select OK to continue the installation
   
   Image Added
   
   
9. Once the adapter is installed you will be prompted to restart the server. Select Yes Restart Now.
   Image Removed
   Image Added
   

Installing GEP using Eclipse update manager

A video desktop demonstration of Installing the Apache Geronimo Eclipse Plugin with the Eclipse Update Manager is available.

1. Once you have all the prerequisites installed. Launch Eclipse from <Eclipse_Home>/eclipse.
2. By default Eclipse will be launched with Java EE perspective.
3. Select Help->Software Updates>Install New Software... from the menu.
   
   Image Modified
   
   
4. On the next screen select Available Software tab. Select Add Site Add... to add repositories.
   Image Removed Image Added
   
   
5. Copy and paste the following site to the Add SiteRepository window and Select Ok OK.
   Code Blockhtml
   
   
   html http://apache.org/dist/geronimo/eclipse/updates/ Image Added
   Image Removed
   
   
6. Expand http://apache.org/dist/geronimo/eclipse/updates/ and Select select Geronimo v2.1 .5 Server Adapter v2.1.57. Select Next.
   
   Image Modified
   
   
7. Once done you have to wait Wait a few seconds while Eclipse resolves dependencies.
   Once done, the Install window will pop up. Select Next
   
   Image Added
   
   
8. Accept the license and Select Finish.
   
   Image Added
   
   
9. Installation will start and will take time a few minutes. A progress window will display the jars being installed.
   
   
   
   
10. During the installation, a Selection Needed window will pop up. Click the box of the certification that you trust and select OK to continue the installation
    
    Image Added
    
    
11. Once GEP is installed you will be prompted to restart. Select yes Restart Now.
    
    

Manual Installation

Using updatesite.zip

1. Download the package geronimo-eclipse-plugin-2.1.57-updatesite.zip from http://apache.org/dist/geronimo/eclipse/2.1.57/.
2. Once done, unzip the package to a directory on your machine.
3. Follow the instructions in #Installing GEP using Eclipse update manager section. When adding a an update site in step 5, choose Local, and navigate to the directory where you unzipped the updatesite.zip package in the previous step.

...

1. Download the package geronimo-eclipse-plugin-2.1.57-deployable.zip from http://apache.org/dist/geronimo/eclipse/2.1.57/.
2. Once done, unzip the package to your eclipse installation directory. For Ganymede, unzip to the eclipse/dropins directory. You may get a prompt regarding file replacement. Select All.
3. Restart eclipse with the -clean option.

...

1. Select Help->About Eclipse Platform.
   
   Image Modified
   
   
2. You can see a G icon in the About Eclipse Platform. This confirms the successful installation of GEP. Click the icon.
   Image Removed
   Image Added
   
   
3. On the next screen you can view details- License, Plug-in-Details and set the Columns of the table being displayed.
   Image Removed
   Image Added

Uninstalling GEP

GEP may be uninstalled in a similar manner in which it was installed.

You can cleanly uninstalled GEP only if you have installed it cleanly. To do so, install your GEP by using Eclipse update manager. If your GEP was installed within WTP, reinstall it with Eclipse update manager to update some meta information so that a clean uninstallation can be preformed with the following steps:

1. Select Help->About Eclipse Platform.
   
   Image Added
   
   
2. Select Installation Details.
   
   Image Added
   
   
3. On the next screen, select Geronimo v2Select Geronimo V2.1 Server Adapter v2.1.5 adapter and select Next7 and then Uninstall...
   Image Removed
   
   Image Added
   
   
4. An Uninstall window pops up displaying the details of the Geronimo v2.1 Server Adapter. Review the information Accept the license agreement and select Finish.
   Image Removed
   Next screen
   Image Added
   
   
5. Uninstallation starts and will take a few minutes. An Uninstalling Software window displays the uninstallation progress.
   
   Image Added
   
   
6. Once GEP is uninstalled will ask for confirmation. Select Ok. Once done Geronimo V2.1.5 server adapter will be downloaded and installed.
   Image RemovedOnce the adapter is installed you will be prompted to restart the server. Select Yes Restart Now.
   Image Removed Image Added
   

...

Uninstalling GEP using Eclipse update manager

A video desktop demonstration of Installing the Apache Geronimo Eclipse Plugin with the Eclipse Update Manager is available.

You can also uninstall GEP by using Eclipse update manager with the following steps:

1. Select Help->Install New Software.
2. Once you have all the prerequisites installed. Launch Eclipse from <Eclipse_Home>/eclipse.
3. By default Eclipse will be launched with Java EE perspective.
4. Select Help->Software Updates.. from the menu.
   
   Image Modified
   
   
5. On the next screen select Available Software tab. Select Add Site What is already installed?.
   Image Removed
   Image Added
   
   
6. Copy and paste the following site to Add Site window and Select Ok.
   Code Blockhtmlhtml

   
   http://apache.org/dist/geronimo/eclipse/updates/
   

   Image Removed
   Expand http://apache.org/dist/geronimo/eclipse/updates/ and Select On the next screen, select Geronimo v2.1 .5 Server Adapter v2.1.7 and then Uninstall.5..
   Image Removed
   Once done you have to wait a few seconds while Eclipse resolves dependencies.
   
7. Once done, the Install window will pop up. Select Next

Image Removed

1. 
   Image Added
   
   
2. An Uninstall window pops up displaying the details of the Geronimo v2.1 Server Adapter. Review the information and select Finish.
   
   Image Added
   
   
3. Uninstallation starts and will take a few minutes.
   
4. Once GEP is uninstalled Accept the license and Select Finish.
   Image Removed
   Installation will start and will take time few minutes. A progress window will display the jars being installed.
   Image Removed
   Once GEP is installed you will be prompted to restart. Select yes.
   Image Removed

Manual Installation

Using updatesite.zip

1. Download the package geronimo-eclipse-plugin-2.1.5-updatesite.zip from http://apache.org/dist/geronimo/eclipse/2.1.5/.
2. Once done, unzip the package to a directory on your machine.
3. Follow the instructions in #Installing GEP using Eclipse update manager section. When adding a an update site in step 5, choose Local, and navigate to the directory where you unzipped the updatesite.zip package in the previous step.

Using deployable.zip

1. Download the package geronimo-eclipse-plugin-2.1.5-deployable.zip from http://apache.org/dist/geronimo/eclipse/2.1.5/.
2. Once done, unzip the package to your eclipse installation directory. For Ganymede, unzip to the eclipse/dropins directory. You may get a prompt regarding file replacement. Select All.
3. Restart eclipse with the -clean option.

Verify GEP installation

...

Uninstalling GEP

GEP may be uninstalled in a similar manner in which it was installed.

...

1. Restart Now.

...

Uninstall does not work well on Ganymede and Galileo, especially for GEP. It will uninstall GEP, but then you can't reinstall it, as it doesn't really get uninstalled. The only way to reinstall GEP in Ganymede is to reinstall Ganymede itself! It's the same for Galileo. See Eclipse Bugzilla 244935 for details, and hopefully a fix soon!

...