...
This topic is organized in the following sections:
| Table of Contents |
|---|
Installing as
...
prebuilt plugins
The recommended practice for Geronimo is to set up a workflow using geronimo Geronimo plugins and maven from development through test and production. To demonstrate this, the samples are built into plugins suitable for the jetty Jetty and tomcat web Tomcat Web containers in geronimoGeronimo. Many samples require database access. This is encapsulated into a separate plugin (sample-datasource).
...
For installation you need a geronimo Geronimo server with a web Web container installed, such as the geronimo-jetty-minimal or geronimo-jetty6-javaee5 servers (or the equivalent tomcat Tomcat variations).
Installing through the
...
administrative console
...
If you are using one of the javaee5 Java EE 5 server assemblies you can use the admin administrative 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 Install. Be sure to select only plugins for the web Web container you have installed (e.g. jetty plugins for the jetty 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 #Installing through gshellGShell) if you are using one of the minimal assemblies that does not include the admin administrative console.
Installing through
...
GShell
For this you can use any geronimo Geronimo server such as one 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. Alternatively if you build using
...
| Note |
|---|
-Pit is currently only available in the samples trunk (2.2-SNAPSHOT) and not branches/2.1 (2.1.3-SNAPSHOT) or tags/samples-parent-2.1.2 (2.1.2) |
Building from
...
source
Downloading the
...
source code
The 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.
...
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. The trunk for samples always contains samples for the highest level version under development https://svn.apache.org/repos/asf/geronimo/samples/trunk
Building the
...
samples
Build the samples using this command:
| Code Block | ||||
|---|---|---|---|---|
| ||||
mvn clean install |
...
There are minimal integration tests to assure that the sample plugins can be installed on the framework server. To run this tests use this command:
| Code Block | ||||
|---|---|---|---|---|
| ||||
mvn clean install -Pit |
| Note |
|---|
The integration tests are not available prior to Geronimo Samples 2.2 |
Deploying the
...
built samples as Java EE
...
artifacts
With the sample datasource installed as a plugin
...
(or the equivalent -tomcat directory). For most samples you will need have to install the sample-datasource plugin first. Samples can be deployed from the admin administrative console "deploy new" on a suitable server or using gshell GShell ./bin/gsh deploy/deploy. Note that in this case you need have 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 than the plugin method.
...
You can also install the sample datasource as a javaee artifact using the plan we generate when building the plugin, install the sample datasource using the admin administrative console using the database wizard, and run the sql by hand rather than relying on the geronimo DBInitializationGBean.
Installing the sample datasource as a
...
Java EE artifact
...
Before you install any sample applications, deploy the org.tranql/tranql-connector-derby-embed-xa/1.4/rar connector located in the geronimo repo at org/tranql/tranql-connector-derby-embed-xa/1.4/tranql-connector-derby-embed-xa-1.4.rar with the plan at sample-datasource/target/resources/META-INF/plan.xml using the admin console "deploy new" or gshellGShell. This will have exactly the same effect as installing the sample-datasource plugin.
...