You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@aries.apache.org by bu...@apache.org on 2010/12/27 19:31:47 UTC
svn commit: r781778 [6/15] - in /websites/staging/aries/trunk/content:
community/ development/ documentation/ documentation/tutorials/ downloads/
downloads/archived-releases/ downloads/ct/ downloads/ct/current-release/
modules/ modules/samples/ overvie...
Added: websites/staging/aries/trunk/content/downloads/ariestrader-0.2-incubating.html
==============================================================================
--- websites/staging/aries/trunk/content/downloads/ariestrader-0.2-incubating.html (added)
+++ websites/staging/aries/trunk/content/downloads/ariestrader-0.2-incubating.html Mon Dec 27 18:31:45 2010
@@ -0,0 +1,300 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+ <head>
+ <link type="text/css" rel="stylesheet" href="resources/site.css"></link>
+ <script src="resources/space.js" type="text/javascript"></script>
+ </script><script src="resources/getMenu.js" language="javascript" type="text/javascript"></script>
+ <meta name="keywords" content="..."/>
+ <meta name="description" content="..." />
+ <title>
+ Apache Aries - AriesTrader
+ </title>
+ </head>
+<body onload="init()">
+
+<table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2"> </td>
+ <td id="cell-0-1"> </td>
+ <td id="cell-0-2" colspan="2"> </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0"> </td>
+ <td id="cell-1-1"> </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <!-- Banner -->
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+ <a href="http://incubator.apache.org/aries/" title="Apache Aries"> <img border="0" src="images/Arieslogo_Horizontal.gif"> </a>
+ </td>
+ <td align="right" nowrap="">
+ <a href="http://www.apache.org/" title="The Apache Software Foundation"> <img border="0" src="images/apache_feather.png"> </a>
+ </td>
+ </tr>
+ </table>
+ <!-- Banner -->
+ </div>
+ </div>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left">
+ <!-- Breadcrumbs -->
+ <!-- Breadcrumbs -->
+ </div>
+ </td>
+ <td>
+ <div align="right">
+ <!-- Quicklinks -->
+ <DIV style="padding: 5px 5px 0px 25px;">
+ <FORM action="http://www.google.com/search" method="get" style="font-size: 10px;">
+ <A href="http://www.apache.org/licenses/LICENSE-2.0.html" class="external-link" rel="nofollow">License</A> <A href="sitemap.html" title="SiteMap">Site Map</A>
+ <INPUT name="ie" type="hidden" value="UTF-8"></INPUT>
+ <INPUT name="oe" type="hidden" value="UTF-8"></INPUT>
+ <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT>
+ <INPUT name="btnG" type="submit" value="Search"></INPUT>
+ <INPUT name="domains" type="hidden" value="incubator.apache.org/aries"></INPUT>
+ <INPUT name="sitesearch" type="hidden" value="incubator.apache.org/aries"></INPUT>
+ </FORM>
+ </DIV>
+ <!-- Quicklinks -->
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </td>
+ <td id="cell-1-3"> </td>
+ <td id="cell-1-4"> </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2"> </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <!-- NavigationBar -->
+ <ul>
+<li><h3><a href="overview.html">Overview</a></h3><ul>
+<li><h4><a href="boardreports.html">Board Reports</a></h4></li>
+<li><h4><a href="sitemap.html">Site Map</a></h4></li>
+</ul>
+</li>
+<li><h3><a href="documentation.html">Documentation</a></h3><ul>
+<li><h4><a href="ariesprogrammingmodel.html">Programming Model</a></h4></li>
+<li><h4><a href="pointerstoosgispecifications.html">Pointers to OSGi specs</a></h4></li>
+<li><h4><a href="integrators-guide.html">Integrators Guide</a></h4></li>
+<li><h4><a href="articles.html">Articles</a></h4></li>
+<li><h4><a href="https://svn.apache.org/repos/asf/incubator/aries/slides/">Slides</a></h4></li>
+<li><h4><a href="tutorials.html">Tutorials</a></h4></li>
+</ul>
+</li>
+<li><h3><a href="downloads.html">Downloads</a></h3></li>
+<li><h3><a href="community.html">Community</a></h3><ul>
+<li><h4><a href="gettinginvolved.html">Getting Involved</a></h4></li>
+<li><h4><a href="people.html">Who we are</a></h4></li>
+<li><h4><a href="mailinglists.html">Mailing lists</a></h4></li>
+<li><h4><a href="http://blogs.apache.org/aries/">Aries Group Blog</a></h4></li>
+</ul>
+</li>
+<li><h3><a href="development.html">Development</a></h3><ul>
+<li><h4><a href="https://svn.apache.org/repos/asf/incubator/aries/">Source Control </a></h4></li>
+<li><h4><a href="https://issues.apache.org/jira/browse/ARIES">Bug Tracking</a></h4></li>
+<li><h4><a href="buildingaries.html">Building Aries </a></h4></li>
+<li><h4><a href="releasingaries.html">Releasing Aries </a></h4></li>
+<li><h4><a href="compliancetesting.html">OSGi Compliance Tests </a></h4></li>
+<li><h4><a href="http://hudson.zones.apache.org/hudson/">Build System</a></h4></li>
+<li><h4><a href="maintainingthewebpages.html">Web Site Maintenance </a></h4></li>
+</ul>
+</li>
+<li><h3><a href="modules.html">Modules</a></h3><ul>
+<li><h4><a href="samples.html">Samples</a></h4></li>
+<li><h4><a href="blueprint.html">Blueprint</a></h4></li>
+<li><h4><a href="jndiproject.html">JNDI</a></h4></li>
+<li><h4><a href="jpaproject.html">JPA</a></h4></li>
+<li><h4><a href="applications.html">Applications</a></h4></li>
+<li><h4><a href="transactionsproject.html">Transactions</a></h4></li>
+<li><h4><a href="-ebamavenpluginproject.html">EBA Maven Plugin </a></h4></li>
+<li><h4><a href="spi-fly.html">SPI Fly</a></h4></li>
+</ul>
+</li>
+<li><h3> <a href="sponsorship.html">Sponsorship</a></h3></li>
+</ul>
+ <!-- NavigationBar -->
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <!-- Content -->
+ <div class="wiki-content"><p><a name="AriesTrader-TheAriesTraderSample"></a></p>
+<h1 id="the_ariestrader_sample">The AriesTrader Sample</h1>
+<p><a name="AriesTrader-Prereqs"></a></p>
+<h3 id="prereqs">Prereqs</h3>
+<br>
+
+<hr />
+<p><strong>Note:</strong> </p>
+<p>These instructions are for the 0.2-incubating release of Aries.
+Instructions for older releases can be found <a href="archiveinstructions.html">here</a>
+. In the 0.2-incubating release the AriesTrader sample was changed such
+that it is no longer required for you to install Derby independently. The
+Derby version included in the sample is fully leveraged internally in the
+sample and therefore no additional Derby installation is required.
+However, there are steps required to initialize the Database from within
+the sample itself (see instructions below).<br />
+</p>
+<hr />
+<p><a name="AriesTrader-CreatingtheOSGiplatform(equinox-test-harness)forAriesTrader"></a></p>
+<h3 id="creating_the_osgi_platform_equinox-test-harness_for_ariestrader">Creating the OSGi platform (equinox-test-harness) for AriesTrader</h3>
+<p>Download and unzip the source zip for the <a href="aries:downloads.html">latest release</a>
+ of Aries Samples and build the equinox-test-harness module under
+ariestrader:</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="n">samples</span><span class="o">-</span><span class="mi">0</span><span class="o">.</span><span class="mi">2</span><span class="o">-</span><span class="n">incubating</span><span class="sr">/ariestrader/</span><span class="n">assemblies</span><span class="o">/</span><span class="n">equinox</span><span class="o">-</span><span class="n">test</span><span class="o">-</span><span class="n">harness</span>
+<span class="n">mvn</span> <span class="n">install</span>
+</pre></div>
+
+
+<p>This procedure will pull in the binaries from the latest release and its
+dependencies.</p>
+<p><a name="AriesTrader-AlternativebuildusingApacheAriestrunk."></a></p>
+<h3 id="alternative_build_using_apache_aries_trunk">Alternative build using Apache Aries trunk.</h3>
+<p>As an alternative to using the released version you can also choose to work
+with the latest, unreleased code. This will require the use of subversion
+to checkout the code followed by building the entire Apache Aries project.
+Directions are provided here: <a href="aries:buildingaries.html">Building Aries instructions</a>
+.</p>
+<p><a name="AriesTrader-StartingtheEquinoxTestHarnesstoruntheAriesTradersample"></a></p>
+<h3 id="starting_the_equinox_test_harness_to_run_the_ariestrader_sample">Starting the Equinox Test Harness to run the AriesTrader sample</h3>
+<p>AriesTrader needs a test harness to run in. For this purpose we are using
+an Equinox assembly that pulls in all of the necessary dependencies.<br />
+</p>
+<p>The first task is to start the Apache Aries modules in an OSGi framework
+using the Eclipse Equinox test harness</p>
+<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">jar</span> <span class="n">osgi</span><span class="o">-</span><span class="mi">3</span><span class="o">.</span><span class="mi">5</span><span class="o">.</span><span class="mi">0</span><span class="o">.</span><span class="n">v20090520</span><span class="o">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">console</span>
+</pre></div>
+
+
+<p>The OSGi console should start up, the 'ss' command should show the active
+bundles but the AriesTrader application is not yet installed (with the
+exception of the ariestrader derby datasource which is started with the
+test harness for convenience).<br />
+</p>
+<p><a name="AriesTrader-InstallingAriesTraderintheEquinoxTestHarness"></a></p>
+<h3 id="installing_ariestrader_in_the_equinox_test_harness">Installing AriesTrader in the Equinox Test Harness</h3>
+<p>To install the AriesTrader application simply copy the eba for AriesTrader
+into the target/load directory which was created when test harness
+containing Aries was started. For convenience the AriesTraders EBAs are
+copied into the target directory as part of creating the OSGi Equinox test
+harness. </p>
+<p>When using the "JDBC" only AriesTrader configuration which supports only
+jdbc persistence:</p>
+<div class="codehilite"><pre><span class="n">cp</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">aries</span><span class="o">.</span><span class="n">samples</span><span class="o">.</span><span class="n">ariestrader</span><span class="o">.</span><span class="n">jdbc</span><span class="o">-*.</span><span class="n">eba</span> <span class="n">load</span><span class="o">/</span>
+</pre></div>
+
+
+<p>When using the "All" AriesTrader configuration which supports all currently
+available persistence modes:</p>
+<div class="codehilite"><pre><span class="n">cp</span> <span class="n">org</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">aries</span><span class="o">.</span><span class="n">samples</span><span class="o">.</span><span class="n">ariestrader</span><span class="o">.</span><span class="n">all</span><span class="o">-*.</span><span class="n">eba</span> <span class="n">load</span><span class="o">/</span>
+</pre></div>
+
+
+<p>Now the 'ss' command should show all of the AriesTrader bundles in state
+'ACTIVE'.</p>
+<p>If you subsequently delete org.apache.aries.samples.ariestrader.jdbc-<em>.eba
+or org.apache.aries.samples.ariestrader.all-</em>.eba from the target/load
+directory the application will be uninstalled.</p>
+<p><a name="AriesTrader-AccessingandusingtheAriesTradersample"></a></p>
+<h3 id="accessing_and_using_the_ariestrader_sample">Accessing and using the AriesTrader sample</h3>
+<p>Point your browser at <a href="http://localhost:8080/org.apache.aries.samples.ariestrader.web/">http://localhost:8080/org.apache.aries.samples.ariestrader.web/</a></p>
+<p>Select the "Configuration" tab and the "Configure AriesTrader run-time
+parameters" choice. Then select from among the available runtime modes
+(defauls to JDBC). Be sure to click "update config" to save your
+selection.</p>
+<p>At the moment the following persistence modes are available when using the
+"all" EBA:
+<em> JDBC persistence
+</em> JPA application managed entity manager persistence
+* JPA container managed entity managers using declarative transaction
+support<br />
+</p>
+<p>By default, the sample starts with JDBC persistence. To select another
+persistence mechanism see the directions under "Accessing and using the
+AriesTrader sample. </p>
+<p>After selecting the persistence mode you must create the AriesTrader
+Database tables and indexs. Select the "Configuration" tab and the
+"(Re)-create AriesTrader Tables and Indexes". </p>
+<p>Next, you must seed the database with test content. Once again go to the
+"Configuration" tab but this time select "(Re)-populate AriesTrader
+Database" from the available choices to seed the database with a default
+set of users and stock quotes. You will see a number of quotes (default is
+400) and users (default is 200) created.</p>
+<p>Select the "Trading & Portfolios" tab to use the mock trade application or
+the "Primitives" tab to run some of the web primitive tests (PingJSPEL is
+not currently working). You can also run the "Test AriesTrader Scenario"
+from the "Configuration" tab which will launch a new browser window and
+step through a trading scenario with each reload of the page.</p>
+<p><a name="AriesTrader-AbouttheAriesTraderSample"></a></p>
+<h3 id="about_the_ariestrader_sample">About the AriesTrader Sample</h3>
+<p>The AriesTrader sample is a modified version of the Apache Geronimo
+DayTrader sample. It has been somewhat simplified and reorganized to
+support the Apache Aries programming model.<br />
+</p>
+<p>The AriesTrader sample bundles are organized like this:</p>
+<p><img alt="at2" src="ariesTraderOverview2.png" /></p></div>
+ <!-- Content -->
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2"> </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0"> </td>
+ <td id="cell-3-1"> </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <!-- Footer -->
+ <div id="site-footer">
+ <a href="http://incubator.apache.org/aries/privacy-policy.html";>Privacy
+Policy</a>
+ </div>
+ <!-- Footer -->
+ </div>
+ </td>
+ <td id="cell-3-3"> </td>
+ <td id="cell-3-4"> </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2"> </td>
+ <td id="cell-4-1"> </td>
+ <td id="cell-4-2" colspan="2"> </td>
+ </tr>
+</table>
+</body>
+</html>
Added: websites/staging/aries/trunk/content/downloads/blogsample-0.2-incubating.html
==============================================================================
--- websites/staging/aries/trunk/content/downloads/blogsample-0.2-incubating.html (added)
+++ websites/staging/aries/trunk/content/downloads/blogsample-0.2-incubating.html Mon Dec 27 18:31:45 2010
@@ -0,0 +1,255 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<html>
+ <head>
+ <link type="text/css" rel="stylesheet" href="resources/site.css"></link>
+ <script src="resources/space.js" type="text/javascript"></script>
+ </script><script src="resources/getMenu.js" language="javascript" type="text/javascript"></script>
+ <meta name="keywords" content="..."/>
+ <meta name="description" content="..." />
+ <title>
+ Apache Aries - Blog Sample
+ </title>
+ </head>
+<body onload="init()">
+
+<table width="100%" cellpadding="0" cellspacing="0">
+ <tr width="100%">
+ <td id="cell-0-0" colspan="2"> </td>
+ <td id="cell-0-1"> </td>
+ <td id="cell-0-2" colspan="2"> </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-1-0"> </td>
+ <td id="cell-1-1"> </td>
+ <td id="cell-1-2">
+ <div style="padding: 5px;">
+ <div id="banner">
+ <!-- Banner -->
+ <table border="0" cellpadding="0" cellspacing="0" width="100%">
+ <tr>
+ <td align="left" class="topbardiv" nowrap="">
+ <a href="http://incubator.apache.org/aries/" title="Apache Aries"> <img border="0" src="images/Arieslogo_Horizontal.gif"> </a>
+ </td>
+ <td align="right" nowrap="">
+ <a href="http://www.apache.org/" title="The Apache Software Foundation"> <img border="0" src="images/apache_feather.png"> </a>
+ </td>
+ </tr>
+ </table>
+ <!-- Banner -->
+ </div>
+ </div>
+ <div id="top-menu">
+ <table border="0" cellpadding="1" cellspacing="0" width="100%">
+ <tr>
+ <td>
+ <div align="left">
+ <!-- Breadcrumbs -->
+ <!-- Breadcrumbs -->
+ </div>
+ </td>
+ <td>
+ <div align="right">
+ <!-- Quicklinks -->
+ <DIV style="padding: 5px 5px 0px 25px;">
+ <FORM action="http://www.google.com/search" method="get" style="font-size: 10px;">
+ <A href="http://www.apache.org/licenses/LICENSE-2.0.html" class="external-link" rel="nofollow">License</A> <A href="sitemap.html" title="SiteMap">Site Map</A>
+ <INPUT name="ie" type="hidden" value="UTF-8"></INPUT>
+ <INPUT name="oe" type="hidden" value="UTF-8"></INPUT>
+ <INPUT maxlength="255" name="q" size="15" type="text" value></INPUT>
+ <INPUT name="btnG" type="submit" value="Search"></INPUT>
+ <INPUT name="domains" type="hidden" value="incubator.apache.org/aries"></INPUT>
+ <INPUT name="sitesearch" type="hidden" value="incubator.apache.org/aries"></INPUT>
+ </FORM>
+ </DIV>
+ <!-- Quicklinks -->
+ </div>
+ </td>
+ </tr>
+ </table>
+ </div>
+ </td>
+ <td id="cell-1-3"> </td>
+ <td id="cell-1-4"> </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-2-0" colspan="2"> </td>
+ <td id="cell-2-1">
+ <table>
+ <tr height="100%" valign="top">
+ <td height="100%">
+ <div id="wrapper-menu-page-right">
+ <div id="wrapper-menu-page-top">
+ <div id="wrapper-menu-page-bottom">
+ <div id="menu-page">
+ <!-- NavigationBar -->
+ <ul>
+<li><h3><a href="overview.html">Overview</a></h3><ul>
+<li><h4><a href="boardreports.html">Board Reports</a></h4></li>
+<li><h4><a href="sitemap.html">Site Map</a></h4></li>
+</ul>
+</li>
+<li><h3><a href="documentation.html">Documentation</a></h3><ul>
+<li><h4><a href="ariesprogrammingmodel.html">Programming Model</a></h4></li>
+<li><h4><a href="pointerstoosgispecifications.html">Pointers to OSGi specs</a></h4></li>
+<li><h4><a href="integrators-guide.html">Integrators Guide</a></h4></li>
+<li><h4><a href="articles.html">Articles</a></h4></li>
+<li><h4><a href="https://svn.apache.org/repos/asf/incubator/aries/slides/">Slides</a></h4></li>
+<li><h4><a href="tutorials.html">Tutorials</a></h4></li>
+</ul>
+</li>
+<li><h3><a href="downloads.html">Downloads</a></h3></li>
+<li><h3><a href="community.html">Community</a></h3><ul>
+<li><h4><a href="gettinginvolved.html">Getting Involved</a></h4></li>
+<li><h4><a href="people.html">Who we are</a></h4></li>
+<li><h4><a href="mailinglists.html">Mailing lists</a></h4></li>
+<li><h4><a href="http://blogs.apache.org/aries/">Aries Group Blog</a></h4></li>
+</ul>
+</li>
+<li><h3><a href="development.html">Development</a></h3><ul>
+<li><h4><a href="https://svn.apache.org/repos/asf/incubator/aries/">Source Control </a></h4></li>
+<li><h4><a href="https://issues.apache.org/jira/browse/ARIES">Bug Tracking</a></h4></li>
+<li><h4><a href="buildingaries.html">Building Aries </a></h4></li>
+<li><h4><a href="releasingaries.html">Releasing Aries </a></h4></li>
+<li><h4><a href="compliancetesting.html">OSGi Compliance Tests </a></h4></li>
+<li><h4><a href="http://hudson.zones.apache.org/hudson/">Build System</a></h4></li>
+<li><h4><a href="maintainingthewebpages.html">Web Site Maintenance </a></h4></li>
+</ul>
+</li>
+<li><h3><a href="modules.html">Modules</a></h3><ul>
+<li><h4><a href="samples.html">Samples</a></h4></li>
+<li><h4><a href="blueprint.html">Blueprint</a></h4></li>
+<li><h4><a href="jndiproject.html">JNDI</a></h4></li>
+<li><h4><a href="jpaproject.html">JPA</a></h4></li>
+<li><h4><a href="applications.html">Applications</a></h4></li>
+<li><h4><a href="transactionsproject.html">Transactions</a></h4></li>
+<li><h4><a href="-ebamavenpluginproject.html">EBA Maven Plugin </a></h4></li>
+<li><h4><a href="spi-fly.html">SPI Fly</a></h4></li>
+</ul>
+</li>
+<li><h3> <a href="sponsorship.html">Sponsorship</a></h3></li>
+</ul>
+ <!-- NavigationBar -->
+ </div>
+ </div>
+ </div>
+ </div>
+ </td>
+ <td height="100%" width="100%">
+ <!-- Content -->
+ <div class="wiki-content"><p><a name="BlogSample-TheBlogSample"></a></p>
+<h1 id="the_blog_sample">The Blog Sample</h1>
+<p><a name="BlogSample-RunningtheBlogSample"></a></p>
+<h2 id="running_the_blog_sample">Running the Blog Sample</h2>
+<br>
+
+<hr />
+<p><strong>Note:</strong>
+These instructions are for the 0.2-incubating release of Aries.
+Instructions for older releases can be found <a href="archived-releases/blogsample-0.1-incubating.html">here</a>
+. In the 0.2-incubating release the sample was changed to use an in-memory
+database to avoid dependency on an explicit version of Derby. If you would
+prefer to use a database on disk check the instructions for the
+0.1-incubating release. You will also need to modify datasource.xml (under
+blog-datasource) as indicated in the comments and then rebuild the sample.</p>
+<hr />
+<p><a name="BlogSample-CreatetheOSGiplatformfortheBlogsample"></a></p>
+<h3 id="create_the_osgi_platform_for_the_blog_sample">Create the OSGi platform for the Blog sample</h3>
+<p>Download and unzip the source zip for the <a href="aries:downloads.html">latest release</a>
+ of Aries Samples and build the blog-assembly module:</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="n">samples</span><span class="o">-</span><span class="mi">0</span><span class="o">.</span><span class="mi">2</span><span class="o">-</span><span class="n">incubating</span><span class="sr">/blog/</span><span class="n">blog</span><span class="o">-</span><span class="n">assembly</span>
+<span class="n">mvn</span> <span class="n">install</span>
+</pre></div>
+
+
+<p>This procedure will pull in the binaries from the latest release and its
+dependencies.</p>
+<p><a name="BlogSample-RunningtheBlogsample"></a></p>
+<h3 id="running_the_blog_sample_1">Running the Blog sample</h3>
+<p>Download the JDBC based Blog sample application (.eba file) from the <a href="aries:downloads.html">latest release</a>
+. Change directory to the blog-assembly target directory:</p>
+<div class="codehilite"><pre><span class="n">cd</span> <span class="n">samples</span><span class="o">-</span><span class="mi">0</span><span class="o">.</span><span class="mi">2</span><span class="o">-</span><span class="n">incubating</span><span class="sr">/blog-sample/</span><span class="n">blog</span><span class="o">-</span><span class="n">assembly</span><span class="o">/</span><span class="n">target</span>
+</pre></div>
+
+
+<p>now start Aries in an OSGi framework (we're using Eclipse Equinox in this
+case)</p>
+<div class="codehilite"><pre><span class="n">java</span> <span class="o">-</span><span class="n">jar</span> <span class="n">osgi</span><span class="o">-</span><span class="mi">3</span><span class="o">.</span><span class="mi">5</span><span class="o">.</span><span class="mi">0</span><span class="o">.</span><span class="n">v20090520</span><span class="o">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">console</span>
+</pre></div>
+
+
+<p>The OSGi console should start up, the 'ss' command should show all of the
+Blog bundles in state 'ACTIVE'.</p>
+<p>Now start the blog application (.eba file) you downloaded earlier, by
+copying it into the load directory which was created when Aries started.</p>
+<p>Point your browser to <a href="http://localhost:8080/org.apache.aries.samples.blog.web/">http://localhost:8080/org.apache.aries.samples.blog.web/</a></p>
+<p>If you subsequently delete the .eba from the load directory the application
+will be uninstalled.</p>
+<p><a name="BlogSample-RunningthesampleusingaJPApersistencelayer"></a></p>
+<h3 id="running_the_sample_using_a_jpa_persistence_layer">Running the sample using a JPA persistence layer</h3>
+<p>The first blog sample application was written to use a JDBC persistence
+layer. There is a second application implemented to demonstrate the JPA
+capability</p>
+<p>To run the blog sample which uses the JPA persistence layer, start the OSGi
+framework, remove any previous copies of the blog sample from the
+target/load directory, then copy the Blog sample JPA .eba file into the
+load directory.</p>
+<p>Finally, after typing 'refresh' at the OSGi console, point your browser at <a href="http://localhost:8080/org.apache.aries.samples.blog.web/">http://localhost:8080/org.apache.aries.samples.blog.web/</a>
+. You should see something that looks precisely the same as the blog sample
+running with the JDBC persistence layer, but this time running using the
+JPA persistence layer.</p>
+<p><a name="BlogSample-Usingthelatest,unreleasedcode"></a></p>
+<h2 id="using_the_latest_unreleased_code">Using the latest, unreleased code</h2>
+<p>If you prefer to use the very latest code from subversion, checkout and
+build the Aries trunk by following the <a href="aries:buildingaries.html">Building Aries instructions</a>
+.</p>
+<p><a name="BlogSample-AbouttheBlogsample"></a></p>
+<h2 id="about_the_blog_sample">About the Blog sample</h2>
+<p>The blog sample components can be visualised like this:</p>
+<p>!BlogSample.png!</p></div>
+ <!-- Content -->
+ </td>
+ </tr>
+ </table>
+ </td>
+ <td id="cell-2-2" colspan="2"> </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-3-0"> </td>
+ <td id="cell-3-1"> </td>
+ <td id="cell-3-2">
+ <div id="footer">
+ <!-- Footer -->
+ <div id="site-footer">
+ <a href="http://incubator.apache.org/aries/privacy-policy.html";>Privacy
+Policy</a>
+ </div>
+ <!-- Footer -->
+ </div>
+ </td>
+ <td id="cell-3-3"> </td>
+ <td id="cell-3-4"> </td>
+ </tr>
+ <tr width="100%">
+ <td id="cell-4-0" colspan="2"> </td>
+ <td id="cell-4-1"> </td>
+ <td id="cell-4-2" colspan="2"> </td>
+ </tr>
+</table>
+</body>
+</html>