...
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:
- Launch eclipse by running <eclipse_home>/eclipse.
- 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.
- Select Apache Geronimo v2.1 Server and click Next.
- 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.)
- 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.
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.
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:
- 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.
- Click Add to launch New Server Runtime dialog.
- Select Apache Geronimo v2.1 Runtime, check Also create new local server and click Next.
- Select a 5.0 JRE, enter the directory name or browse to the directory where Geronimo 2.1 server is installed and click Next.
- 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.
- 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
...