You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 28 Next »

Welcome to Apache Geronimo Development Tools Subproject

Welcome to the Apache Geronimo Development Tools Subproject. The aim of this subproject is to provide a rich set of development tools for Geronimo, focusing on application development, migration, and IDE integration.

Geronimo Eclipse Plug-in

The Geronimo Eclipse plug-in provides integration between Geronimo and the Web Tools Project. With this plug-in, users will be able to use the features in WTP to create, deploy and debug applications for Geronimo.

Prerequisites

Several prerequisites are required to be downloaded and installed. Visit the WTP download site and download the WebTools Platform Runtime 2.0.1 driver along with its prerequisites as mentioned in the Requirements section. Here is the full list of prerequisites:

  1. Sun JDK 5.0+ (J2SE 1.5)
  2. Eclipse 3.3.1 (Eclipse Classic package of Europa distribution), which is platform specific
  3. Web Tools Platform (WTP) 2.0.1
  4. Data Tools Platform (DTP) 1.5.1
  5. Eclipse Modeling Framework (EMF) 2.3.1
  6. Graphical Editing Framework (GEF) 3.3.1

Downloads

Latest Release - Version 2.0.0
Version 2.0.0 of the Geronimo Eclipse Plug-in has been released. The latest release supports deployment to Geronimo 2.0.x and all previous versions. See the release notes for additional information.

Daily Drivers
Unofficial daily drivers are available for download here. The available builds should also be used with all official releases of Geronimo. These drivers require WTP 2.0.1 and its prerequisites.

Additional Information

  1. Geronimo Eclipse Plug-in Installation Instructions
  2. Geronimo Eclipse Plug-in Build Instructions
  3. Geronimo Eclipse Plug-in Usage Instructions
  4. Geronimo Eclipse Plug-in FAQs
  5. Developing Geronimo in Eclipse
  6. Developing the Geronimo Eclipse Plug-in in Eclipse

Installation Alternatives

  1. 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 "Don't see your server listed?" link when defining a server runtime in WTP. Select it, then select Geronimo 2.0.1 and the installation process will begin. Once the workbench restarts Geronimo 2.0.1 support will be available.
  2. Alternatively, the plug-in can be also be installed via the update manager by creating a new remote site pointing to http://geronimo.apache.org/devtools.
  3. Download and install the plugin manually. Download the plugin from here and unzip it into the same directory where all the prereqs were 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 Geronimo Server configuration.

Usage Instructions

  1. To define a new server:
    From Eclipse select:
    • File --> New --> Other --> Server --> Server --> Next --> Apache. At this point you must see the Apache Geronimo v2.0 Server selection or the plugin was not installed/unzipped correctly.
    • Select "Apache Geronimo v2.0 Server" --> Next --> then enter:
      • For Installation Alternative #1,#2 the directory where you want the server installed. Make sure the directory already exists (e.g., c:\temp). Then select Tomcat or Jetty server you want with the radio button, then click the "Download and Install" button. After a confirmation message, your selected server should download and unzip (it takes a few minutes). Then enter --> Next --> Next --> Next --> Finish
      • For Installation Alternative #3 above: the root directory of your Geronimo server installation --> Next --> Next --> Next --> Finish
    • Now in the Java EE perspective you should see the Apache Geronimo v2.0 server (bottom pane, middle tab usually) that you can now start in Eclipse (either right-click on it and select start or select the little green and white start icon on the far right of the server pane). You should then see the console and the familiar server startup messages.
    • Right-click on the server and select "Launch Geronimo Console" to bring up an admin console browser window in Eclipse.
  2. To deploy an application:
    After you've created a project that is targeted for Geronimo 2.0.1, the next step is to deploy your application onto the server. To do this, you must first define a new server (see above). Now you can right click on the server and select "Add-Remove" projects. This associates the project to the given server. If the server is already started, your application will deploy. If stopped, then start your server by clicking the green and white start icon and the server will be started and afterwards your application will be deployed.

JBoss to Geronimo Migration Tool (J2G)

The JBoss to Geronimo Migration Tool (J2G) is an Eclipse plugin designed to assist in migrating the sources of an application written for the JBoss application server or written for Java 2 Enterprise Edition (J2EE) to the Apache Geronimo platform. More information can be found here.

Prerequisites

  1. Sun JDK 5.0+ (J2SE 1.5)
  2. Eclipse SDK 3.3 with JDT Core Plug-in
  3. Apache Geronimo 1.1.1 and up
  4. Application written for JBoss 3.2 and up or J2EE 1.2 and up

Downloads

Latest Release - Version 1.0.0
The first release of the J2G migration tool can be downloaded from the wiki page for the tool here:

Daily Drivers
Unofficial daily drivers are available for download here. The available builds should also be used with all official releases of Geronimo. These drivers require WTP 2.0.1 and its prerequisites.

Additional Information

  1. J2G installation/build instructions
  2. J2G usage instructions

Issues and Questions

Geronimo Eclipse or J2G Plugin issues can be opened in JIRA in the GERONIMODEVTOOLS project. Eclipse Platform or WTP issues should be opened under Eclipse Bugzilla.

Questions regarding either plugin can be asked on the Geronimo mailing lists. Other questions pertaining to Eclipse, WTP, or any Eclipse Project should be asked on the Eclipse Newsgroups.

News

2007-05-14
ApacheCon Europe 2007 in Amsterdam
Presentation titled "J2EE Application Development on Apache Geronimo Simplified using Eclipse". Click here to view.

2007-09-07
Above presentation updated for Java EE 5.0 and Geronimo 2.0.1
Click here to view.

2007-09-07
Java Developers Day 2007 in Krakow
Click here to view.

2007-11-14
EclipseWorld 2007
Presentation titled "Using Eclipse and Geronimo to Develop, Debug, and Profile Java EE Applications, Part 1"
Presentation titled "Using Eclipse and Geronimo to Develop, Debug, and Profile Java EE Applications, Part 2"
Click here to view.

2006-11-14
Webcast: Using the Geronimo Eclipse Plugin
This presentation will provide an introduction to the Eclipse Plugin to deploy and test applications to Apache Geronimo, the full-featured, fully-certified J2EE server from the Apache Software Foundation. Click here to access the webcast.

  • No labels