THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
...
Installing Geronimo Eclipse Plugin
| Note |
|---|
The definitive and current version of the GEP installation instructions may be found here: How to install Geronimo Eclipse Plugin v2.1.2. |
The Geronimo Eclipse Plugin (GEP) can be installed using the following options:
- Using WTP
- Using Eclipse Update Manager
- Manual Installation
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:
- Launch Eclipse by running <eclipse_home>/eclipse.
- 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
- Click on the Download additional server adapters link.
- In the Install New Server Adapter dialog, select Geronimo v2.1 Server Adapter and click Next.
- Read and accept any License Agreements and click Finish. Click OK to continue installation.
...
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:
- Launch Eclipse by running <eclipse_home>/eclipse.
- Open the Eclipse Update Manager as follows:
- Select Help, Software Updates, Find and Install.
- Select Search for new features to install and click Next.
- 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.
- Click the New Remote Site... button.
- Select only the Geronimo Eclipse Update Site in the Sites to include in search selection box and click Finish.
- Select a mirror and click OK if prompted to do so.
- In the Search Results, expand Geronimo Eclipse Update Site and Geronimo WTP Server Adapters.
- Select Geronimo Core Feature 2.1.0 and Geronimo v2.1 Server Adapter 2.1.0 and click Next.
- Read and accept any license agreements and click Next.
- Click Finish to download the selected features.
- Click Install All.
- Click Finish to complete the installation.
- Click Yes to restart Eclipse for the changes to take effect.
Manual Installation of GEP
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.
| Note | ||
|---|---|---|
The definitive and current version of the GEP installation instructions may be found here: How to install Geronimo Eclipse Plugin v2.1.2 | ||
| Warning | ||
| ||
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.
...