Installing and configuring for Geronimo servers

This section describes a summary of how to install Apache Geronimo and configure Rational® Software Delivery Platform (Rational SDP) to enable creating ZIETrans web applications targeted for Apache Geronimo servers:

Download and install the Apache Geronimo server with the Tomcat web container:
  1. Download Apache Geronimo from the Download site at http://geronimo.apache.org/downloads.html.
  2. Install the server by extracting the .zip or .tar files.
  3. Run the server from a command line window by changing the directory to geronimo_home/bin and entering the command: geronimo run.

The Geronimo Eclipse Plugin (GEP) provides integration between Eclipse, its Web Tools Platform (WTP) project, and Geronimo that enables you to utilize WTP features to develop, test, and deploy applications for the Apache Geronimo server using Rational SDP.

Install the Geronimo Eclipse Plugin (GEP):
  1. Follow the instructions on the Installing Geronimo Eclipse Plugin site at https://cwiki.apache.org/GMOxDOC22/installing-geronimo-eclipse-plugin.html.
  2. GEP v2.2 includes server adapters for v1.1.x, v2.0.x, v2.1.x, and v2.2 Apache Geronimo servers.
Configure Geronimo as a target server in Rational SDP for ZIETrans web applications:
  1. On the Rational SDP menu bar, click Window > Preferences.
  2. In the left panel, expand Server.
  3. Click Runtime Environments.
  4. In the Server Runtime Environments panel, click Add.
  5. In the New Server Runtime Environment dialog, expand the Apache folder.
  6. Select the appropriate version of the Apache Geronimo server.
  7. Optional. Select the Create a new local server box to create a new Geronimo server on your workspace Servers tab. Doing this step enables you to test your Geronimo application within the Rational SDP local test environment using the Run on Server, Debug on Server, and Profile on Server functions.
  8. Click Next to go to the panel where you point to your local Geronimo server. In the Application server installation Directory field enter the root folder where you extracted the Geronimo server files. For example, if you extracted your Geronimo server zip to a folder named C:\geronimo-tomcat6-javaee5-2.1.7, enter this value in the installation directory field.
  9. Click Finish.
  10. Click OK to close the Preferences panel.

After following these steps, you can create ZIETrans applications within Rational SDP targeted for Apache Geronimo servers.