...

Download the GEP 2.1 from http://www.apache.org/dist/geronimo/eclipse/^{Image Removed}. 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:

1. Launch eclipse by running <eclipse_home>/eclipse.
2. 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.
     Image Added
3. Select Apache Geronimo v2.1 Server and click Next.
   Image Added
4. 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 the directory where Geronimo 2.1 server is installed and click Next. (Note: Download options part of this dialog does not work currently.)
   Image Added
5. 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.
6. 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 Added

This completes defining a new Geronimo 2.1 Server runtime and 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

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 Added
2. Click Add to launch New Server Runtime dialog.
3. Select Apache Geronimo v2.1 Runtime, check Also create new local server and click Next.
   Image Added
4. Select a 5.0 JRE, enter the directory name or browse to the directory where Geronimo 2.1 server is installed and click Next.
   Image Added
5. 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.
6. Modify Hostname, Administrator Id, Administrator password, Web Connector port and RMI Naming port if necessary.
   Image Added
7. Click Finish to return to Installed Server Runtime Environments dialog.

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

Configuring your development environment

...