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-SNAPSHOT server
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 from:
Building the Aries Samples
You must build the Aries Samples locally until they are released. In the interim you can perform the following steps:
svn co https://svn.apache.org/repos/asf/incubator/aries/trunk aries-trunk cd aries-trunk/parent mvn clean install cd aries-trunk/eba-maven-plugin mvn clean install cd aries-trunk 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-trunk/samples/blog/blog-jpa-eba/target/org.apache.aries.samples.blog.jpa.eba-0.1-incubating-SNAPSHOT.eba
- AriesTrader - aries-trunk/samples/ariestrader/assemblies/ariestrader-all-eba/target/org.apache.aries.samples.ariestrader.all-0.2-incubating-SNAPSHOT.eba
Start the Geronimo Server
Use your favorite command to start the Geronimo Server of choice
Deploy the 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 (either Blog, AriesTrader, or both) 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-SNAPSHOT.eba AND/OR ./bin/deploy -u system -p manager deploy org.apache.aries.samples.ariestrader.all-0.1-incubating-SNAPSHOT.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.