Page History

...

You can find more details on the samples here:

• Aries Blog Sample
• AriesTrader Sample

Obtaining a Geronimo 3.0-

...

M1 server

Anchor
geronimo geronimo

...

You can download an image of the "Geronimo Non-Certified Web Container" (either Tomcat or Jetty) from this location:
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:

M1 download page

Follow the Apache Geronimo documentation to unpack and start the server image (Hint: unzip or untar the server image and use something like "./bin/geronimo.sh run" to start the server).

Obtaining the

...

Aries Samples

Anchor
aries aries

...

You must build the Aries Samples locally until they are released. In the interim you can perform the following steps:

...

...

There are several choices to obtain the Apache Aries EBA samples.

1. You can choose to obtain the source code and build the samples yourself. This is useful if you are using the samples as a learning tool to build your own application.
2. You can also choose to simply download the EBAs from the latest Apache Aries samples release without building Apache Aries.

In either case, you can find the necessary downloads (source or EBA artifacts) at this location:
Latest Apache Aries Release

Building the Apache Aries samples

Anchor
aries-build aries-build

If you choose not to build the samples you can skip to Deploy the Aries Samples DataSource
Download and unzip the source zip for the Latest Apache Aries 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-trunk/samples/blog/blog-jpa-eba/target/org.apache.aries.samples.blog.jpa.eba-0.1-incubating-SNAPSHOT.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-trunk/samples/ariestrader/assemblies/ariestrader-all-eba/target/org.apache.aries.samples.ariestrader.all-0.21-incubating-SNAPSHOT.eba

...

Deploy the Aries Samples DataSource

Anchor

...

aries-

...

deploy

...

aries-

...

deploy

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 However, before you can deploy the Datasources you need to obtain the tranql-connector-derby-embed-xa rar. Unfortunately, this was not included in the Geronimo 3.0-M1 server images (but will be included in future images).

• For 3.0-M1 release you can obtain the necessary rar from any of the ibiblio mirrors: Tranql RAR for derby
• You must also download the XML for the datasource definitions - located here: aries-datasource.xml.

Use After you have both of the necessary files in your local file system use the following command to deploy the datasource:

./bin/deploy -u system -p manager deploy ~/.m2/repository/org/tranql/tranql-connector-derby-embed-xa/1.5/tranql-connector-derby-embed-xa-1.56.rar aries-datasource.xml

Deploy the Sample EBA

Deploy either the Blog , or AriesTrader , or both sample 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-SNAPSHOT.eba
AND/OR.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-SNAPSHOT.eba

Running the Samples

You should now be able to access the samples as follows:

• Blog - http://localhost:8080/blog^{Image Removed}
• AriesTrader - http://localhost:8080/ariestrader^{Image Removed}

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.