Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Click Window -> Preferences -> Server -> Installed Runtimes.
    Image Removed
    Image Added

  2. Click Add to launch New Server Runtime dialog.
  3. 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.
    Image Removed
    Image Added

  4. Select Workbench default JRE (Click Installed JREs to add any new JREs and return to this dialog once done).
  5. You must already have a Geronimo v2.1 installation that you want to use with GEP; enter the directory name or browse to <GERONIMO_HOME> and click Next.
  6. Select the location of the archive containing Geronimo source. This is required only if you intend to debug into Geronimo source code.
  7. Click Finish to return to Installed Server Runtime Environments dialog.
    Image Removed
    Image Added

Additional Server Runtimes to use a different Geronimo server installation or a different JRE can be added in a similar manner.

...

  1. Launch the Define a New Server dialog using one of the following:
    • From the Servers view in the Java EE Perspective: Right-click, and New -> Server.
    • From any Perspective: Select File -> New -> Other -> Server.
      Image Removed
      Image Added

  2. Select Apache Geronimo v2.1 Server, select an Apache Geronimo v2.1 Runtime from the Server runtime dropdown and click Next.
    Image Removed
    Image Added

    Note

    Additional Geronimo Server Runtimes can be installed by clicking on Installed Runtimes button and return to this step once done to select the newly added server runtime.

  3. Modify Hostname, Administrator Id, Administrator password, Web Connector port and RMI Naming port if necessary and click Finish. Normally you will not have to change the default values for these fields for a newly installed Geronimo 2.1 server.
    Image Removed
    Image Added

This completes defining a new Geronimo 2.1 Server. The newly added server will appear in the Servers view. The server can be started by selecting the server and clicking on the Start server button.

Image Modified

Note

A Geronimo Server can also be defined while creating a Geronimo Server Runtime by checking the option Also create new local server. This will present an additional dialog to configure the hostname, ports, etc.

...

Once Geronimo Server Runtimes are defined, Eclipse provides these runtime for selecting as a target runtime while creating an EJB, Web and Java EE projects. Notice the Target Runtime field in the Dynamic Web Project dialog shown in the figure below.
Image Removed
Image Added

Upon adding the Geronimo 2.1 Server Runtime as the target runtime, the Geronimo server libraries and Java EE specification libraries get automatically added to the build path of the project. GEP will also create Geronimo specific deployment plans.

...