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 anyoneThe first time building samples it is required that you build from the top level directory. After the initial build, you can do subsequent builds of specific samples as necessary.

You need svn and maven installed on your system.

...

Installing samples as plugins

Recommended The recommended practice for geronimo 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 . This is encapsulated into a separate plugin (sample-datasource).

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

Installing through the admin console.

For this For installation you need a geronimo server with a web container installed, such as the geronimo-jetty-minimal or geronimo-jetty6-javaee5 servers (or the equivalent tomcat variations).

Installing through the admin console.

If you are using one of the javaee5 server assemblies you can use the admin console to install the plugins. 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 sample-datasource plugin will be installed automatically. There are equivalent command line functions (described next under Installing through gshell) if you are using one of the minimal assemblies that does not include the admin console.

...

For this you can use any geronimo server such as geronimo-frameworkone of the minimal assemblies or even the framework assembly. After starting geronimo, run ./bin/gsh deploy/list-plugins in another terminal window and follow the instructions. Installing a sample plugin will install the sample-datasource plugin and all other dependencies such as the required web container. Alternatively if you build using

...

<sample>/<sample>-jetty/target/geronimo-framework-<version>/.

Deploying samples as javaee artifacts.

...