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
At this point in time Aries 0.1-incubating is in the process of being released. Once it is released you will be able to just build (or download) the sample applications.
However, in the interim you can do the following:
svn co https://svn.apache.org/repos/asf/incubator/aries/tags aries-tags cd aries-tags/parent-0.1-incubating mvn clean install cd aries-tags/eba-maven-plugin-0.1-incubating mvn clean install cd aries-tags/testsupport-0.1-incubating mvn clean install cd aries-tags/org.apache.aries.util-0.1-incubating mvn clean install cd aries-tags/blueprint-0.1-incubating mvn clean install cd aries-tags/jndi-0.1-incubating mvn clean install cd aries-tags/transaction-0.1-incubating mvn clean install cd aries-tags/web-0.1-incubating mvn clean install cd aries-tags/application-0.1-incubating mvn clean install cd aries-tags/jmx-0.1-incubating mvn clean install cd aries-tags/jpa-0.1-incubating mvn clean install cd aries-tags/samples-0.1-incubating mvn clean install
Once the Aries 0.1-incubating samples (and other artifacts) have been released you should be able to just do the following:
svn co https://svn.apache.org/repos/asf/incubator/aries/tags/samples-0.1-incubating aries-samples cd aries-samples mvn clean install
What you are really interested in here are the sample EBAs for Blog and AriesTrader which can be found at:
- Blog - aries-tags/samples-0.1-incubating/blog/blog-jpa-eba/target/org.apache.aries.samples.blog.jpa.eba-0.1-incubating.eba
- AriesTrader - aries-tags/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 either Blog, AriesTrader, or both sample EBAs using the Geronimo web console or the following commands:
./bin/deploy -u system -p manager deploy org.apache.aries.samples.blog.jpa.eba-0.1-incubating.eba AND/OR ./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.