Versions Compared

Key

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

...

Two builds of Geronimo exist, with Jetty or Tomcat servlet container enabled by default. You can download either one at http://geronimo.apache.org/downloads.html, they are slightly larger than 60 MB in size. This document was written primarily using Jetty version, but Tomcat version works fine also.

Previous versions additionally included a GUI installer, which is not available on the download page now. However, you can build the installer from sources. You will get a geronimo-installer-1.1.jar file, 56 MB in size.

Obtaining SPECjAppServer2004

...

Installing Geronimo

You can easily install Geronimo using one of the following – the .zip archive, the .jar GUI installer or an installation script. Installation script is created by the GUI installer at the previous installation.

Installing from a .zip file

Extract the downloaded archive to a local directory. The geronimo-1.1 directory is created, that is your <GERONIMO> directory.

Installing with the .jar installer

Run:

Panel
borderStylesolid

java -jar geronimo-installer-1.1.jar

Click Next, read and accept the license agreement, and type in the directory you want Geronimo installed to. This directory will be your <GERONIMO> directory.

In the components list, deselect either Tomcat Web Container or Jetty Web Container to save yourself configuration effort, as you only need one servlet container to run SPECjAppServer2004.

Leave other settings intact. Click Next.

On the following tabs, leave the default values for the user name (system), password (manager) and port numbers, just click Next.

If you did not turn off one of the servlet containers earlier, make sure you provide different port numbers for them, otherwise they would conflict on that.

Wait until the installation completes, then click Next, and again Next.

At this stage, you may create an installation script to re-install Geronimo later.

Click Done.

Installing with an installation script

To re-install Geronimo (possibly, on a different machine) using the installation script created by GUI installer earlier, run the installer as follows:

Panel
borderStylesolid

java -jar geronimo-installer-1.1.jar <installation script>

The script doest not start GUI and asks for no additional settings, but just follows the pre-set installation scenario.

or .tar.gz archive.

Extract the downloaded archive to a local directory. The geronimo-1.1 directory is created, that is your <GERONIMO> directoryThe installation directory is the same as per the initial installation. If you wish to install to another location, edit the installation script beforehand: change the <installpath> tag value to the desired <GERONIMO> location.

Installing SPECjAppServer2004

...

At this stage you need to deploy the configured components to Geronimoto Geronimo.

Info

Note that if your geronimo.host and your driver.host are the same machine, and you changed the port number of the Geronimo RMI Registry, you should specify that port number in all deployer commands, like this:

Panel
borderStylesolid

java -jar bin/deployer.jar --port 1199 ...

Deploying database connector

...

Panel
borderStylesolid

java -jar bin/deployer.jar --user system --password manager deploy repository/tranql/tranql-connector-derby-embed-xa/1.1/tranql-connector-derby-embed-xa-1.1.rar <KIT>/specdbsjas-db.xml

You will get the Deployed SPEC/SPECjAppServerDB/1.05/car diagnostic.

...

Panel
borderStylesolid

java -jar bin/deployer.jar --user system --password manager deploy repository/geronimo/ge-activemq-rar/1.1/ge-activemq-rar-1.1.rar <KIT>/specjmssjas-jms.xml

You will get the Deployed SPEC/SPECjAppServerJMS/1.05/car diagnostic.

...

To deploy SPECjAppServer2004 on Geronimo, this configuration uses the slightly modified deployment plan that was originally found in Geronimo sources at http://svn.apache.org/viewcvs.cgi/geronimo/sandbox/specjappserver2004/specj2004-deployment-plan.xml., modified and updated for Geronimo version 1.1.

Go to the <GERONIMO> directory and run:

...

You will get the Deployed SPEC/SPECjAppServer/1.05/ear diagnostic.

Info

Note an important issue about this deployment plan: http://www.ibm.com/support/docview.wss?rs=2327&uid=swg21229335

Verifying the deployment

At this stage you may check that the deployment has been done correctly and that SPECjAppServer2004 is operational.

...

Panel
borderStylesolid

java -jar bin/deployer.jar --user system --password manager deploy <SPEC>/jars/Emulator.war <KIT>/Emulatorsjas-emulator.xml

You will get the Deployed SPEC/Emulator/1.05/war @ http://geronimo.host:8080/Emulator diagnostic.

...