Sample applications

General Instructions

Obtaining and building

While it is possible to build each sample separately you may be less likely to run into odd maven problems if you check out and build all the samples at once. This is a small amount of code so should not be a major burden on anyone.

You need svn and maven v 2.0.9 or later installed on your system.

To check out the trunk samples:

svn co https://svn.apache.org/repos/asf/geronimo/samples/trunk

Depending on when you look you may find earlier or released versions of the samples under samples/branches and samples/tags. You can browse in any web browser to see what's there.

Build using

mvn clean install

There are minimal smoke tests to assure that the sample plugins can be installed on the framework server. To run this tests use

mvn clean install -Pit

(not available before geronimo 2.2 and possibly 2.1.2)

Installing samples as plugins

Recommended practice for geronimo is to set up a workflow using geronimo plugins and maven from development through test and production. To demonstrate part of this the samples are built into plugins suitable for the jetty and tomcat web containers in geronimo. Many samples require database access and this is encapsulated into a separate plugin.

In any case, to install samples as plugins you need to build them first.

Installing through the admin console.

For this you need a geronimo server with a web container installed, such as the geronimo-jetty-minimal or geronimo-jetty6-javaee5 servers. In the admin console go to the plugins page, push the "Show Plugins" button, find the sample(s) you want to install, and click install. Be sure to select only plugins for the web container you have installed (e.g. jetty plugins for the jetty web container). Any necessary dependencies such as the SampleDatabase plugin will be installed automatically.

Installing through gshell

For this you can use any geronimo server such as geronimo-framework. After starting geronimo, run ./bin/gsh deploy/list-modules in another terminal window and follow the instructions. Installing a sample plugin will install the sample database plugin and all other dependencies such as the required web container.

Deploying samples as javaee artifacts.

Many samples also include a suitable geronimo plan allowing you to deploy them as javaee applications. For most samples you will need to install the sample database plugin first. Samples can be deployed from the admin console "deploy new" on a suitable server or using gshell ./bin/gsh deploy/deploy. Note that in this case you need to start with a server with all the required bits already installed, not the framework server. Since this installation method is not tested automatically it is more likely to be broken that the plugin method.

Sample applications available