Versions Compared

Key

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

...

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.

Defining Servers

Follow the steps below to define a new Geronimo v2.1 Server:

Geronimo Server Runtimes and Servers

A Geronimo Server Runtime in GEP associates a Geronimo 2.1 Server installation with a JRE to be used to run that server. A Geronimo Server in GEP associates a Geronimo Server Runtime with a profile consisting of Security settings, Publish Settings, Port Configuration, Java VM settings to be used with that Geronimo Server Runtime.

Defining a Geronimo Server Runtime

In order to define a new Geronimo Server v2.1 Runtime, follow the steps below:

  1. Click Window, Preferences, Server, Installed Runtimes.

    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 Added
  4. Launch eclipse by running <eclipse_home>/eclipse.
  5. Launch the Define a New Server dialog using one of the following:
  6. From the Servers view in the Java EE Perspective: Right-click, New, Server.
  7. From any Perspective: Select File, New, Other, Server.
    Image Removed
    Select Apache Geronimo v2.1 Server and click Next.
    Image Removed

  8. Select Workbench default JRE (click Installed JREs to add any new JREs and return to this dialog once done), enter the directory name or browse to <geronimo_home> and click Next. (Note: Download options part of this dialog does not work currently.)



  9. Select the location of the archive containing Geronimo source and click Next. This is required only if you intend to debug into Geronimo source code.Modify Hostname, Administrator Id, Administrator password, Web Connector port and RMI Naming port if necessary and click Finish. Normally you will not need to change the default values for these fields for a newly installed Geronimo 2.1 server.
    Image Removed

...

  1. Click Finish to return to Installed Server Runtime Environments dialog.

    Image Added

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

Defining a Geronimo Server

Follow the steps below to define a new Geronimo v2.1 Server:

  1. Launch the Define a New Server

Additional servers using the same Geronimo 2.1 installation can be defined in a similar manner. If you intend to define additional servers that use a different Geronimo 2.1 installation, you will need to create a new Server runtime as given below:

  1. Launch the Installed Server Runtime Environments dialog using one of the following:
    • In Define a New Server dialog, click on Installed Runtimes... button.
    • Click Window, Preferences, Server, Installed Runtimes.
      Image Removed
    Click Add to launch New Server Runtime dialog.
    • From the Servers view in the Java EE Perspective: Right-click, New, Server.
    • From any Perspective: Select File, New, Other, Server.

      Image Added

  2. Select Apache Geronimo v2.1 Runtime, check Also create new local server and click Next.
    Image Removed
    Select a 5.0 JRE, enter the directory name or browse to the directory where Geronimo 2.1 server is installed Server, select an Apache Geronimo v2.1 Runtime from the Server runtime dropdown and click Next.
    Image Removed
    Select the location of the archive containing Geronimo source and click Next. This is required only if you intend to debug into Geronimo source code.
    Image Added

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


  4. Click Finish to return to Installed Server Runtime Environments dialog.

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 Added The newly added server runtime can be selected from Server runtime drop-down in Define a New Server dialog while defining a new server.

Creating a new project

To create a new Web project, follow the steps below:

...