aries-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cummi...@apache.org
Subject svn commit: r1387152 [3/6] - in /aries: scripts/ site/trunk/content/downloads/ site/trunk/content/downloads/archived-releases/0.3/
Date Tue, 18 Sep 2012 13:43:03 GMT
Added: aries/site/trunk/content/downloads/archived-releases/0.3/ariestrader-0.3.mdtext
URL: http://svn.apache.org/viewvc/aries/site/trunk/content/downloads/archived-releases/0.3/ariestrader-0.3.mdtext?rev=1387152&view=auto
==============================================================================
--- aries/site/trunk/content/downloads/archived-releases/0.3/ariestrader-0.3.mdtext (added)
+++ aries/site/trunk/content/downloads/archived-releases/0.3/ariestrader-0.3.mdtext Tue Sep
18 13:43:02 2012
@@ -0,0 +1,136 @@
+Title: AriesTrader
+
+<a name="AriesTrader-TheAriesTraderSample"></a>
+# The AriesTrader Sample
+
+
+<a name="AriesTrader-Prereqs"></a>
+### Prereqs 
+<br>
+
+- - -
+**Note:** 
+
+These instructions are for the 0.2-incubating release of Aries.
+Instructions for older releases can be found [here](archiveinstructions.html)
+. 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).  
+ 
+- - -
+
+<a name="AriesTrader-CreatingtheOSGiplatform(equinox-test-harness)forAriesTrader"></a>
+### Creating the OSGi platform (equinox-test-harness) for AriesTrader 
+Download and unzip the source zip for the [latest release](aries:downloads.html)
+ of Aries Samples and build the equinox-test-harness module under
+ariestrader:
+
+    cd samples-0.2-incubating/ariestrader/assemblies/equinox-test-harness
+    mvn install
+
+This procedure will pull in the binaries from the latest release and its
+dependencies.
+
+<a name="AriesTrader-AlternativebuildusingApacheAriestrunk."></a>
+### Alternative build using Apache Aries trunk.
+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:  [Building Aries instructions](aries:buildingaries.html)
+.
+
+
+<a name="AriesTrader-StartingtheEquinoxTestHarnesstoruntheAriesTradersample"></a>
+### Starting the Equinox Test Harness to run the AriesTrader sample
+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.  
+
+
+The first task is to start the Apache Aries modules in an OSGi framework
+using the Eclipse Equinox test harness
+
+    cd samples-0.2-incubating/ariestrader/assemblies/equinox-test-harness/target
+    java -jar osgi-3.5.0.v20090520.jar -console
+
+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).	
+
+<a name="AriesTrader-InstallingAriesTraderintheEquinoxTestHarness"></a>
+### Installing AriesTrader in the Equinox Test Harness
+To install the AriesTrader application simply copy the eba for AriesTrader
+into the target/load directory, you will need to create this directory first.  
+For convenience the AriesTraders EBAs are
+copied into the target directory as part of creating the OSGi Equinox test
+harness. 
+
+When using the "JDBC" only AriesTrader configuration which supports only
+jdbc persistence:
+
+    cp org.apache.aries.samples.ariestrader.jdbc-*.eba load/
+
+
+When using the "All" AriesTrader configuration which supports all currently
+available persistence modes:
+
+    cp org.apache.aries.samples.ariestrader.all-*.eba load/
+
+
+Now the 'ss' command should show all of the AriesTrader bundles in state
+'ACTIVE'.
+
+If you subsequently delete org.apache.aries.samples.ariestrader.jdbc-*.eba
+or org.apache.aries.samples.ariestrader.all-*.eba from the target/load
+directory the application will be uninstalled.
+
+
+<a name="AriesTrader-AccessingandusingtheAriesTradersample"></a>
+### Accessing and using the AriesTrader sample
+Point your browser at [http://localhost:8080/ariestrader/](http://localhost:8080/ariestrader/)
+
+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.
+
+At the moment the following persistence modes are available when using the
+"all" EBA:
+* JDBC persistence
+* JPA application managed entity manager persistence
+* JPA container managed entity managers using declarative transaction
+support  
+
+By default, the sample starts with JDBC persistence.  To select another
+persistence mechanism see the directions under "Accessing and using the
+AriesTrader sample. 
+ 
+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". 
+
+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.
+
+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.
+
+<a name="AriesTrader-AbouttheAriesTraderSample"></a>
+### About the AriesTrader Sample
+
+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.  
+
+The AriesTrader sample bundles are organized like this:
+
+![at2](ariesTraderOverview2.png)

Added: aries/site/trunk/content/downloads/archived-releases/0.3/blogsample-0.3.mdtext
URL: http://svn.apache.org/viewvc/aries/site/trunk/content/downloads/archived-releases/0.3/blogsample-0.3.mdtext?rev=1387152&view=auto
==============================================================================
--- aries/site/trunk/content/downloads/archived-releases/0.3/blogsample-0.3.mdtext (added)
+++ aries/site/trunk/content/downloads/archived-releases/0.3/blogsample-0.3.mdtext Tue Sep
18 13:43:02 2012
@@ -0,0 +1,94 @@
+Title: Blog Sample
+
+<a name="BlogSample-TheBlogSample"></a>
+# The Blog Sample
+
+
+<a name="BlogSample-RunningtheBlogSample"></a>
+## Running the Blog Sample
+
+
+<br>
+
+- - -
+**Note:**
+These instructions are for the 0.3 release of Aries.
+Instructions for older releases can be found [here](/downloads/archivedrelease.html)
+. 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.
+
+- - - 
+
+
+<a name="BlogSample-CreatetheOSGiplatformfortheBlogsample"></a>
+### Create the OSGi platform for the Blog sample
+
+Download and unzip the source zip for the [latest release](/downloads/currentrelease.html)
+ of Aries Samples and build the blog-assembly module:
+
+    cd samples-0.3/blog/blog-assembly
+    mvn install
+
+This procedure will pull in the binaries from the latest release and its
+dependencies.
+
+<a name="BlogSample-RunningtheBlogsample"></a>
+### Running the Blog sample
+
+Download the JDBC based Blog sample application (.eba file) from the [latest release](/downloads/currentrelrease.html)
+. Change directory to the blog-assembly target directory:
+
+
+    cd samples-0.3/blog-sample/blog-assembly/target
+
+
+now start Aries in an OSGi framework (we're using Eclipse Equinox in this
+case)
+
+    java -jar osgi-3.5.0.v20090520.jar -console
+
+
+The OSGi console should start up, the 'ss' command should show all of the
+Blog bundles in state 'ACTIVE'.
+
+To start the blog application (.eba file) you downloaded earlier, create a directory
+call load and copying it into the load directory.
+
+Point your browser to [http://localhost:8080/blog/](http://localhost:8080/blog/)
+
+If you subsequently delete the .eba from the load directory the application
+will be uninstalled.
+
+<a name="BlogSample-RunningthesampleusingaJPApersistencelayer"></a>
+### Running the sample using a JPA persistence layer
+
+The first blog sample application was written to use a JDBC persistence
+layer. There is a second application implemented to demonstrate the JPA
+capability
+
+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.
+
+Finally, after typing 'refresh' at the OSGi console, point your browser at [http://localhost:8080/blog/](http://localhost:8080/blog/)
+. 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.
+
+<a name="BlogSample-Usingthelatest,unreleasedcode"></a>
+## Using the latest, unreleased code
+
+If you prefer to use the very latest code from subversion, checkout and
+build the Aries trunk by following the [Building Aries instructions](aries:buildingaries.html)
+.
+
+<a name="BlogSample-AbouttheBlogsample"></a>
+## About the Blog sample
+
+The blog sample components can be visualised like this:
+
+![bs](BlogSample.png)

Added: aries/site/trunk/content/downloads/ariestrader-1.0.0.mdtext
URL: http://svn.apache.org/viewvc/aries/site/trunk/content/downloads/ariestrader-1.0.0.mdtext?rev=1387152&view=auto
==============================================================================
--- aries/site/trunk/content/downloads/ariestrader-1.0.0.mdtext (added)
+++ aries/site/trunk/content/downloads/ariestrader-1.0.0.mdtext Tue Sep 18 13:43:02 2012
@@ -0,0 +1,136 @@
+Title: AriesTrader
+
+<a name="AriesTrader-TheAriesTraderSample"></a>
+# The AriesTrader Sample
+
+
+<a name="AriesTrader-Prereqs"></a>
+### Prereqs 
+<br>
+
+- - -
+**Note:** 
+
+These instructions are for the 1.0.0 release of Aries.
+Instructions for older releases can be found [here](archiveinstructions.html)
+. 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).  
+ 
+- - -
+
+<a name="AriesTrader-CreatingtheOSGiplatform(equinox-test-harness)forAriesTrader"></a>
+### Creating the OSGi platform (equinox-test-harness) for AriesTrader 
+Download and unzip the source zip for the [latest release](aries:downloads.html)
+ of Aries Samples and build the equinox-test-harness module under
+ariestrader:
+
+    cd samples-1.0.0-incubating/ariestrader/assemblies/equinox-test-harness
+    mvn install
+
+This procedure will pull in the binaries from the latest release and its
+dependencies.
+
+<a name="AriesTrader-AlternativebuildusingApacheAriestrunk."></a>
+### Alternative build using Apache Aries trunk.
+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:  [Building Aries instructions](aries:buildingaries.html)
+.
+
+
+<a name="AriesTrader-StartingtheEquinoxTestHarnesstoruntheAriesTradersample"></a>
+### Starting the Equinox Test Harness to run the AriesTrader sample
+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.  
+
+
+The first task is to start the Apache Aries modules in an OSGi framework
+using the Eclipse Equinox test harness
+
+    cd samples-1.0.0-incubating/ariestrader/assemblies/equinox-test-harness/target
+    java -jar osgi-3.5.0.v20090520.jar -console
+
+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).	
+
+<a name="AriesTrader-InstallingAriesTraderintheEquinoxTestHarness"></a>
+### Installing AriesTrader in the Equinox Test Harness
+To install the AriesTrader application simply copy the eba for AriesTrader
+into the target/load directory, you will need to create this directory first.  
+For convenience the AriesTraders EBAs are
+copied into the target directory as part of creating the OSGi Equinox test
+harness. 
+
+When using the "JDBC" only AriesTrader configuration which supports only
+jdbc persistence:
+
+    cp org.apache.aries.samples.ariestrader.jdbc-*.eba load/
+
+
+When using the "All" AriesTrader configuration which supports all currently
+available persistence modes:
+
+    cp org.apache.aries.samples.ariestrader.all-*.eba load/
+
+
+Now the 'ss' command should show all of the AriesTrader bundles in state
+'ACTIVE'.
+
+If you subsequently delete org.apache.aries.samples.ariestrader.jdbc-*.eba
+or org.apache.aries.samples.ariestrader.all-*.eba from the target/load
+directory the application will be uninstalled.
+
+
+<a name="AriesTrader-AccessingandusingtheAriesTradersample"></a>
+### Accessing and using the AriesTrader sample
+Point your browser at [http://localhost:8080/ariestrader/](http://localhost:8080/ariestrader/)
+
+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.
+
+At the moment the following persistence modes are available when using the
+"all" EBA:
+* JDBC persistence
+* JPA application managed entity manager persistence
+* JPA container managed entity managers using declarative transaction
+support  
+
+By default, the sample starts with JDBC persistence.  To select another
+persistence mechanism see the directions under "Accessing and using the
+AriesTrader sample. 
+ 
+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". 
+
+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.
+
+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.
+
+<a name="AriesTrader-AbouttheAriesTraderSample"></a>
+### About the AriesTrader Sample
+
+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.  
+
+The AriesTrader sample bundles are organized like this:
+
+![at2](ariesTraderOverview2.png)

Added: aries/site/trunk/content/downloads/blogsample-1.0.0.mdtext
URL: http://svn.apache.org/viewvc/aries/site/trunk/content/downloads/blogsample-1.0.0.mdtext?rev=1387152&view=auto
==============================================================================
--- aries/site/trunk/content/downloads/blogsample-1.0.0.mdtext (added)
+++ aries/site/trunk/content/downloads/blogsample-1.0.0.mdtext Tue Sep 18 13:43:02 2012
@@ -0,0 +1,97 @@
+Title: Blog Sample
+
+<a name="BlogSample-TheBlogSample"></a>
+# The Blog Sample
+
+
+<a name="BlogSample-RunningtheBlogSample"></a>
+## Running the Blog Sample
+
+
+<br>
+
+- - -
+**Note:**
+These instructions are for the 1.0.0 release of Aries.
+Instructions for older releases can be found [here](/downloads/archivedrelease.html)
+. 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.
+
+- - - 
+
+
+<a name="BlogSample-CreatetheOSGiplatformfortheBlogsample"></a>
+### Create the OSGi platform for the Blog sample
+
+Download and unzip the source zip for the [latest release](/downloads/currentrelease.html)
+ of Aries Samples and build the blog-assembly module:
+
+    cd samples-1.0.0/blog/blog-assembly
+    mvn install
+
+This procedure will pull in the binaries from the latest release and its
+dependencies.
+
+<a name="BlogSample-RunningtheBlogsample"></a>
+### Running the Blog sample
+
+Build the JPA based Blog sample application (.eba file) from the [latest release](/downloads/currentrelrease.html)
+    
+    cd samples-1.0.0/blog/blog-jpa-eba
+    mvn install
+
+. Change directory to the blog-assembly target directory:
+
+
+    cd samples-1.0.0/blog-sample/blog-assembly/target
+
+
+now start Aries in an OSGi framework (we're using Eclipse Equinox in this
+case)
+
+    java -jar org.eclipse.osgi-3.7.0.v20110613.jar -console
+
+
+The OSGi console should start up, the 'ss' command should show all of the
+Blog bundles in state 'ACTIVE'.
+
+To start the blog application (.eba file) you built earlier, create a directory
+call load and copying it into the load directory.
+
+Point your browser to [http://localhost:8080/blog/](http://localhost:8080/blog/)
+
+If you subsequently delete the .eba from the load directory the application
+will be uninstalled.
+
+<a name="BlogSample-RunningthesampleusingaJPApersistencelayer"></a>
+### Running the sample using a JPA persistence layer
+
+The first blog sample application is written to use a JPA persistence layer. There is an
earlier application implemented to demonstrate the JDBC
+capability
+
+To run the blog sample which uses the JDBC persistence layer, start the OSGi
+framework, remove any previous copies of the blog sample from the
+target/load directory, then build and copy the Blog sample JDBC .eba file into the
+load directory.
+
+Finally, after typing 'refresh' at the OSGi console, point your browser at [http://localhost:8080/blog/](http://localhost:8080/blog/)
+. You should see something that looks precisely the same as the blog sample
+running with the JPA persistence layer, but this time running using the
+JDBC layer.
+
+<a name="BlogSample-Usingthelatest,unreleasedcode"></a>
+## Using the latest, unreleased code
+
+If you prefer to use the very latest code from subversion, checkout and
+build the Aries trunk by following the [Building Aries instructions](aries:buildingaries.html)
+.
+
+<a name="BlogSample-AbouttheBlogsample"></a>
+## About the Blog sample
+
+The blog sample components can be visualised like this:
+
+![bs](BlogSample.png)



Mime
View raw message