geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache Geronimo Development > Apache Aries Samples running in Geronimo 3.0
Date Tue, 22 Jun 2010 15:43:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/1810/9/1/_/styles/combined.css?spaceKey=GMOxDEV&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/GMOxDEV/Apache+Aries+Samples+running+in+Geronimo+3.0">Apache
Aries Samples running in Geronimo 3.0</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~jbohn">Joe
Bohn</a>
    </h4>
        <br/>
                         <h4>Changes (17)</h4>
                                 
    
<div id="page-diffs">
            <table class="diff" cellpadding="0" cellspacing="0">
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br>h2. Obtaining a Geronimo
3.0-M1 server {anchor: geronimo} <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Until
Geronimo 3.0-M1 is delivered you will have to use Geronimo 3.0-SNAPSHOT. <br>The first
step is to obtain a Geronimo 3.0-SNAPSHOT server javaee6 image (either Jetty or Tomcat should
work). <br>If you prefer you can build your own image after first checking out the code
as follows: <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">You
can download an image of the &quot;Geronimo Non-Certified Web Container&quot; (either
Tomcat or Jetty) from this location: <br>[Geronimo 3.0-M1 download page|http://geronimo.apache.org/apache-geronimo-v30-m1-release.html]
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">{code:border=solid}</span>
<span class="diff-added-words"style="background-color: #dfd;">{note}</span> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">svn
co https://svn.apache.org/repos/asf/geronimo/server/trunk  geronimo-trunk <br>cd geronimo-trunk
<br>mvn clean install <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">You
*must* use a Web Container image and not a &quot;Little-G&quot; (minimal) version
of the server. The Little-G version does not include necessary components for deploying the
Apache Aries samples. <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">{code}</span>
<span class="diff-added-words"style="background-color: #dfd;">{note}</span> <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">Alternatively
you can pull an image from the most recent Geronimo build. <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">Follow
the Apache Geronimo documentation to unpack and start the server image. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h2.
Obtaining the Aries Samples {anchor: aries} <br>There are several choices to obtain
the Apache Aries EBA samples.   <br># 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.   <br># You can also choose to simply download the EBAs from the
latest Apache Aries samples release without building Apache Aries. <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h2.
Building the Aries Samples {anchor: aries} <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">In
either case, you can find the necessary downloads (source or EBA artifacts) at this location:
<br>[Latest Apache Aries Release|ARIES:Downloads] <br> <br> <br>h2.
Building the Apache Aries samples {anchor: aries-build} <br>If you choose not to build
the samples you can skip to [Deploy the Aries Samples DataSource|#aries-deploy]  <br></td></tr>
            <tr><td class="diff-changed-lines" >Download and unzip the source
zip for the <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">[latest
release|ARIES:Downloads]</span> <span class="diff-added-words"style="background-color:
#dfd;">[Latest Apache Aries Release|ARIES:Downloads]</span> of Aries Samples and
build the project. <br></td></tr>
            <tr><td class="diff-unchanged" >{code} <br>cd samples-0.1-incubating/
<br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" >* AriesTrader all sample - samples-0.1-incubating/ariestrader/assemblies/ariestrader-all-eba/target/org.apache.aries.samples.ariestrader.all-0.1-incubating.eba
<br> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h2.
Start the Geronimo Server {anchor: start-server} <br>Use your favorite command to start
the Geronimo Server of choice <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h2.
Deploy the Aries Samples DataSource {anchor: aries-deploy} <br>Each of the two samples
requires a Datasource.  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).   <br>* For 3.0-M1 release
you can obtain the necessary rar from any of the ibiblio mirrors:   [Tranql RAR for derby|
http://mirrors.ibiblio.org/pub/mirrors/maven2/org/tranql/tranql-connector-derby-embed-xa/1.6/]
<br>* You must also download the XML for the datasource definitions - located here:
[aries-datasource.xml|^aries-datasource.xml].  <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h2.
Deploy the Aries Samples DataSource <br>Each of the two samples requires a Datasource.
  You can deploy the datasources for both samples with this one file [aries-datasource.xml|^aries-datasource.xml].
   <br>Use the following command: <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">After
you have both of the necessary files in your local file system use the following command to
deploy the datasource:   <br></td></tr>
            <tr><td class="diff-unchanged" >{code:border=solid} <br></td></tr>
            <tr><td class="diff-changed-lines" >./bin/deploy -u system -p manager
deploy <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">~/.m2/repository/org/tranql/tranql-connector-derby-embed-xa/1.5/tranql-connector-derby-embed-xa-1.5.rar</span>
<span class="diff-added-words"style="background-color: #dfd;">tranql-connector-derby-embed-xa-1.6.rar</span>
aries-datasource.xml <br></td></tr>
            <tr><td class="diff-unchanged" >{code} <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
        </table>
</div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <style type='text/css'>/*<![CDATA[*/
table.ScrollbarTable  {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color:
#f0f0f0}
table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}

/*]]>*/</style><div class="Scrollbar"><table class='ScrollbarTable'><tr><td
width='33%' class='ScrollbarPrevName'>&nbsp;</td><td width='33%' class='ScrollbarParent'><sup><a
href="/confluence/display/GMOxDEV/Index"><img border='0' align='middle' src='/confluence/images/icons/up_16.gif'
width='8' height='8'></a></sup><a href="/confluence/display/GMOxDEV/Index">Index</a></td><td
width='33%' class='ScrollbarNextName'>&nbsp;<a href="/confluence/display/GMOxDEV/Apache+Geronimo+With+A+Monitor+Component+%28JMX+and+JConsole%29">Apache
Geronimo With A Monitor Component (JMX and JConsole)</a></td><td class='ScrollbarNextIcon'><a
href="/confluence/display/GMOxDEV/Apache+Geronimo+With+A+Monitor+Component+%28JMX+and+JConsole%29"><img
border='0' align='middle' src='/confluence/images/icons/forwd_16.gif' width='16' height='16'></a></td></tr></table></div>
<p><a name="ApacheAriesSamplesrunninginGeronimo3.0-top"></a><br/>
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.   </p>

<p>You can find more details on the samples here:</p>
<ul>
	<li><a href="https://cwiki.apache.org/ARIES/blog-sample.html" class="external-link"
rel="nofollow">Aries Blog Sample</a></li>
	<li><a href="https://cwiki.apache.org/ARIES/ariestrader.html" class="external-link"
rel="nofollow">AriesTrader Sample</a></li>
</ul>


<h2><a name="ApacheAriesSamplesrunninginGeronimo3.0-ObtainingaGeronimo3.0M1server"></a>Obtaining
a Geronimo 3.0-M1 server <a name="ApacheAriesSamplesrunninginGeronimo3.0-geronimo"></a></h2>
<p>You can download an image of the "Geronimo Non-Certified Web Container" (either Tomcat
or Jetty) from this location:<br/>
<a href="http://geronimo.apache.org/apache-geronimo-v30-m1-release.html" class="external-link"
rel="nofollow">Geronimo 3.0-M1 download page</a></p>
<div class='panelMacro'><table class='noteMacro'><colgroup><col width='24'><col></colgroup><tr><td
valign='top'><img src="/confluence/images/icons/emoticons/warning.gif" width="16" height="16"
align="absmiddle" alt="" border="0"></td><td>You <b>must</b> use
a Web Container image and not a "Little-G" (minimal) version of the server. The Little-G version
does not include necessary components for deploying the Apache Aries samples.</td></tr></table></div>

<p>Follow the Apache Geronimo documentation to unpack and start the server image.</p>

<h2><a name="ApacheAriesSamplesrunninginGeronimo3.0-ObtainingtheAriesSamples"></a>Obtaining
the Aries Samples <a name="ApacheAriesSamplesrunninginGeronimo3.0-aries"></a></h2>
<p>There are several choices to obtain the Apache Aries EBA samples.  </p>
<ol>
	<li>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.</li>
	<li>You can also choose to simply download the EBAs from the latest Apache Aries samples
release without building Apache Aries.</li>
</ol>


<p>In either case, you can find the necessary downloads (source or EBA artifacts) at
this location:<br/>
<a href="/confluence/display/ARIES/Downloads" title="Downloads">Latest Apache Aries
Release</a></p>


<h2><a name="ApacheAriesSamplesrunninginGeronimo3.0-BuildingtheApacheAriessamples"></a>Building
the Apache Aries samples <a name="ApacheAriesSamplesrunninginGeronimo3.0-ariesbuild"></a></h2>
<p>If you choose not to build the samples you can skip to <a href="#ApacheAriesSamplesrunninginGeronimo3.0-ariesdeploy">Deploy
the Aries Samples DataSource</a> <br/>
Download and unzip the source zip for the <a href="/confluence/display/ARIES/Downloads"
title="Downloads">Latest Apache Aries Release</a> of Aries Samples and build the
project. </p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
cd samples-0.1-incubating/
mvn install
</pre>
</div></div>
<p>This procedure will pull in the binaries from the latest release and its dependencies.</p>

<p>What you are really interested in here are the sample EBAs for Blog and AriesTrader
which can be found at:</p>
<ul>
	<li>Blog jdbc sample - samples-0.1-incubating/blog/blog-jdbc-eba/target/org.apache.aries.samples.blog.jdbc.eba-0.1-incubating.eba</li>
	<li>Blog jpa sample - samples-0.1-incubating/blog/blog-jpa-eba/target/org.apache.aries.samples.blog.jpa.eba-0.1-incubating.eba</li>
	<li>AriesTrader jdbc sample - samples-0.1-incubating/ariestrader/assemblies/ariestrader-jdbc-eba/target/org.apache.aries.samples.ariestrader.jdbc-0.1-incubating.eba</li>
	<li>AriesTrader all sample - samples-0.1-incubating/ariestrader/assemblies/ariestrader-all-eba/target/org.apache.aries.samples.ariestrader.all-0.1-incubating.eba</li>
</ul>


<h2><a name="ApacheAriesSamplesrunninginGeronimo3.0-DeploytheAriesSamplesDataSource"></a>Deploy
the Aries Samples DataSource <a name="ApacheAriesSamplesrunninginGeronimo3.0-ariesdeploy"></a></h2>
<p>Each of the two samples requires a Datasource.  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).
 </p>
<ul>
	<li>For 3.0-M1 release you can obtain the necessary rar from any of the ibiblio mirrors:
  <a href="http://mirrors.ibiblio.org/pub/mirrors/maven2/org/tranql/tranql-connector-derby-embed-xa/1.6/"
class="external-link" rel="nofollow">Tranql RAR for derby</a></li>
	<li>You must also download the XML for the datasource definitions - located here: <a
href="/confluence/download/attachments/20643861/aries-datasource.xml?version=1&amp;modificationDate=1272514919000">aries-datasource.xml</a>.</li>
</ul>


<p>After you have both of the necessary files in your local file system use the following
command to deploy the datasource:  </p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
./bin/deploy -u system -p manager deploy tranql-connector-derby-embed-xa-1.6.rar aries-datasource.xml
</pre>
</div></div>

<h2><a name="ApacheAriesSamplesrunninginGeronimo3.0-DeploytheSampleEBA"></a>Deploy
the Sample EBA </h2>
<p>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):</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">
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
</pre>
</div></div>

<h2><a name="ApacheAriesSamplesrunninginGeronimo3.0-RunningtheSamples"></a>Running
the Samples</h2>
<p>You should now be able to access the samples as follows:</p>
<ul>
	<li>Blog - <a href="http://localhost:8080/blog" class="external-link" rel="nofollow">http://localhost:8080/blog</a></li>
	<li>AriesTrader - <a href="http://localhost:8080/ariestrader" class="external-link"
rel="nofollow">http://localhost:8080/ariestrader</a></li>
</ul>


<p>For details on how to interact with the Samples and the sample structure reference
the following links:</p>
<ul>
	<li><a href="https://cwiki.apache.org/ARIES/blog-sample.html" class="external-link"
rel="nofollow">Aries Blog Sample</a> - specifically reference the "About the Blog
Sample" section.</li>
	<li><a href="https://cwiki.apache.org/ARIES/ariestrader.html" class="external-link"
rel="nofollow">AriesTrader Sample</a> - specifically reference the "Accessing and
using the AriesTrader sample" and the subsequent "About the AriesTrader Sample" sections.</li>
</ul>



    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/GMOxDEV/Apache+Aries+Samples+running+in+Geronimo+3.0">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=20643861&revisedVersion=5&originalVersion=4">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/GMOxDEV/Apache+Aries+Samples+running+in+Geronimo+3.0?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message