...
This topic is organized in the following sections:
Table of Contents |
---|
Installing as prebuilt plugins
...
TODO: Demonstrate how to swap databases using plugins; see also the roller plugin
...
For this you can use any 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
...
you can find a server with the sample installed in directories such as
...
...
-Pit is currently only available in the samples
...
branches/2.2 (2.2.1-SNAPSHOT) and trunk (3.0-SNAPSHOT), not in branches/2.1 (2.1.3-SNAPSHOT) or tags/samples-parent-2.1.2 (2.1.2)
...
You need svn and maven installed on your system.
...
Maven v 2.
...
2.
...
1 or later is required for building Geronimo 2.
...
2 samples.
To check out the 2.1.2 samples:
...
...
...
Alternatively, you could choose to work with the active 2.
...
2 branch of samples. This will allow you to work with the latest changes in samples but will also expose you to a branch that is under active development and so things may be in flux from day to day:
svn co https://svn.apache.org/repos/asf/geronimo/samples/branches/2.
...
2 gsamples-2.
...
2
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:
...
...
...
If you run into the "Could not scan module for TLD files...Filename too long" problem when using Windows platform, please check out samples to a short directory (14 characters or less).
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:
...
...
The integration tests are not available prior to Geronimo Samples 2.2
...
After building the sample projects you can find suitable geronimo plans for a sample <sample> in
...
(or the equivalent -tomcat directory). For most samples you will have to install the sample-datasource plugin first. Samples can be deployed from the administrative console "deploy new" on a suitable server or using GShell ./bin/gsh
deploy/deploy
. Note that in this case you 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.
...
Create a new datasource using the admin console database wizard, selecting the derby-embed-xa type and naming the database "SampleDatabase" and the datasource "SampleTxDatasource". The admin console will come up with a module Id different from what the samples need, so you have to map them in var/config/artifact_aliases.properties. Insert a line like this:
...
...
replacing 2.2 -SNAPSHOT with the appropriate sample version and adjusting the right hand side as necessary. Be sure geronimo is stopped when you edit artifact_aliases.properties.
...
Geronimo Samples 2.2 release did not generate the maven site for javadoc and source xref view. Cause Geronimo site scheme for 2.2 has some problem.
...
There is a maven generated site for samples which can be used to view javadoc and source. It can be found here:
To navigate to javadoc and source code (xref) for each sample do the following:
...