...
The Geronimo Eclipse Plugin (GEP) requires the following prerequisite software (Note: Update the list once GEP 2.1 is released - this plugin has not been released yet but it should be out very soon. You can get the latest unstable version of GEP from http://people.apache.org/dist/geronimo/eclipse/unstable/2.1.0/
).all of which is platform specific):
- Sun JDK 5.0 (J2SE 5.0)
- Eclipse 3.3.1.1 (Eclipse Classic package of Europa distribution)
- Eclipse IDE for Java EE Developers
Sun JDK 5.0
...
can be downloaded from Sun's J2SE 5.0
...
Downloads site. Eclipse and the Eclipse IDE for Java EE Developers can be downloaded in from the Eclipse Downloads site. Download and extract the Eclipse 3.3.1.1 and the Eclipse IDE for Java EE Developers archives to a directory of your choice (for e.g. C:\eclipse). The archive will be extracted to a directory named eclipse under the directory you specified (for e.g. C:\eclipse\eclipse), referred to as <eclipse_home> from now on. Make sure that the JDK in the PATH is Sun JDK 5.0. Launch Eclipse by running <eclipse_home>/eclipse.
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
Sun JDK 5.0 can be downloaded from Sun's J2SE 5.0 Downloads site. WTP and all the other prerequisites can be downloaded from WTP Downloads site.
Geronimo server can be installed from within Geronimo Eclipse Plugin. Optionally you may install Geronimo server before installing GEP. Download Geronimo 2.1 server from http://www.apache.org/dist/geronimo/ 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.
...
- Download the ant script from http://svn.apache.org/repos/asf/geronimo/devtools/eclipse-plugin/trunk/tags/2.1.0/eclipse/build.xml (Note: Change this URL to the one from tag instead of trunk once GEP 2.1 is released) and save to a temporary directory (refer to it as <temp_dir>).
- Open a command window and change directory to <temp_dir>
- Depending on your platform, invoke one of the commands given below:
This will download and extract all the prerequisites to <temp_dir>/eclipse. In this case your <eclipse_home> will be <temp_dir>/eclipse/eclipse.Code Block ant win32 ant linux ant macos
...
- Click Window -> Preferences -> Server -> Installed Runtimes.
- Click Add to launch New Server Runtime dialog.
- Select Apache Geronimo v2.1 Runtime, uncheck Also create new local server (we will discuss about the use of this option later) and click Next.
- Select Workbench default JRE (click Installed JREs to add any new JREs and return to this dialog once done).
- 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.
- Enter a directory for Application Server Installation Directory, under Download Options select the web container and click Download and Install.
Note title Important The directory specified for Application Server Installation Directory should must exist in order to select Download Options.
- Click OK for Install Confirmation. This will install the selected Geronimo v2.1 server and fill the Application Server Installation Directory field accordingly.
- Click Next.
- Select the location of the archive containing Geronimo source. This is required only if you intend to debug into Geronimo source code.
- Click Finish to return to Installed Server Runtime Environments dialog.
...