It is possible to install and run several of the Apache Aries sample EBAs in Apache Geronimo 3.0-SNAPSHOT. These are OSGi enabled Web Applications and other bundles that leverage capabilities such as Blueprint, JNDI, JDBC, JPA, and JTA in OSGi specified ways. The samples are packaged in an EBA for deployment. The current samples are the Aries Blog and AriesTrader.
You can find more details on the samples here:
Obtaining a Geronimo 3.0-M1 server
Until Geronimo 3.0-M1 is delivered you will have to use Geronimo 3.0-SNAPSHOT.
The first step is to obtain a Geronimo 3.0-SNAPSHOT server javaee6 image (either Jetty or Tomcat should work).
If you prefer you can build your own image after first checking out the code as follows:
svn co https://svn.apache.org/repos/asf/geronimo/server/trunk geronimo-trunk cd geronimo-trunk mvn clean install
Alternatively you can pull an image from the most recent Geronimo build.
Building the Aries Samples
Download and unzip the source zip for the latest release of Aries Samples and build the project.
cd samples-0.1-incubating/ mvn install
This procedure will pull in the binaries from the latest release and its dependencies.
What you are really interested in here are the sample EBAs for Blog and AriesTrader which can be found at:
- Blog jdbc sample - samples-0.1-incubating/blog/blog-jdbc-eba/target/org.apache.aries.samples.blog.jdbc.eba-0.1-incubating.eba
- Blog jpa sample - samples-0.1-incubating/blog/blog-jpa-eba/target/org.apache.aries.samples.blog.jpa.eba-0.1-incubating.eba
- AriesTrader jdbc sample - samples-0.1-incubating/ariestrader/assemblies/ariestrader-jdbc-eba/target/org.apache.aries.samples.ariestrader.jdbc-0.1-incubating.eba
- AriesTrader all sample - samples-0.1-incubating/ariestrader/assemblies/ariestrader-all-eba/target/org.apache.aries.samples.ariestrader.all-0.1-incubating.eba
Start the Geronimo Server
Use your favorite command to start the Geronimo Server of choice
Deploy the Aries Samples DataSource
Each of the two samples requires a Datasource. You can deploy the datasources for both samples with this one file aries-datasource.xml.
Use the following command:
./bin/deploy -u system -p manager deploy ~/.m2/repository/org/tranql/tranql-connector-derby-embed-xa/1.5/tranql-connector-derby-embed-xa-1.5.rar aries-datasource.xml
Deploy the Sample EBA
Deploy the Blog or AriesTrader EBAs using the Geronimo web console or the following commands (NOTE: you should only deploy one version of each sample at a time - for example only the jdbc Blog or jpa Blog sample and not both concurrently):
Blog jdbc ./bin/deploy -u system -p manager deploy org.apache.aries.samples.blog.jdbc.eba-0.1-incubating.eba Blog jpa ./bin/deploy -u system -p manager deploy org.apache.aries.samples.blog.jpa.eba-0.1-incubating.eba AriesTrader jdbc ./bin/deploy -u system -p manager deploy org.apache.aries.samples.ariestrader.jdbc-0.1-incubating.eba AriesTrader all ./bin/deploy -u system -p manager deploy org.apache.aries.samples.ariestrader.all-0.1-incubating.eba
Running the Samples
You should now be able to access the samples as follows:
- Blog - http://localhost:8080/blog
- AriesTrader - http://localhost:8080/ariestrader
For details on how to interact with the Samples and the sample structure reference the following links:
- Aries Blog Sample - specifically reference the "About the Blog Sample" section.
- AriesTrader Sample - specifically reference the "Accessing and using the AriesTrader sample" and the subsequent "About the AriesTrader Sample" sections.