| Title: BlogSample-0.1-incubating |
| <a name="BlogSample-0.1-incubating-TheBlogSample-version0.1-incubating."></a> |
| # The Blog Sample - version 0.1-incubating. |
| |
| |
| <a name="BlogSample-0.1-incubating-RunningtheBlogSample"></a> |
| ## Running the Blog Sample |
| |
| |
| <a name="BlogSample-0.1-incubating-Prereqs"></a> |
| ### Prereqs |
| |
| Follow the instructions [here](http://db.apache.org/derby/papers/DerbyTut/install_software.html#derby) |
| to complete the following actions: Download Derby, Install Derby, Set |
| DERBY_INSTALL, Configure Embedded Derby and then Verify Derby. |
| |
| <br> |
| |
| - - - |
| **Note:** |
| The version of Derby used by the current release and development versions |
| of the Blog Sample is 10.5.3.0. Since May 2010 the Derby tutorial points to |
| the latest Derby release (10.6.x) - if this is installed the Blog sample |
| will not work. See [ARIES-317](https://issues.apache.org/jira/browse/ARIES-317) |
| . For the present the best solution is to install Derby 10.5.3. |
| |
| - - - |
| |
| |
| <a name="BlogSample-0.1-incubating-CreatetheOSGiplatformfortheBlogsample"></a> |
| ### Create the OSGi platform for the Blog sample |
| |
| Download and unzip the source zip for the [latest release](aries:downloads.html) |
| of Aries Samples and build the blog-assembly module: |
| |
| cd samples-0.1-incubating/blog/blog-assembly |
| mvn install |
| |
| This procedure will pull in the binaries from the latest release and its |
| dependencies. |
| |
| <a name="BlogSample-0.1-incubating-RunningtheBlogsample"></a> |
| ### Running the Blog sample |
| |
| Download the JDBC based Blog sample application (.eba file) from the [latest release](aries:downloads.html) |
| . |
| |
| Create the database |
| |
| cd samples-0.1-incubating/blog-sample/blog-assembly/target |
| export |
| CLASSPATH=$DERBY_INSTALL/lib/derby.jar:$DERBY_INSTALL/lib/derbytools.jar:. |
| java org.apache.derby.tools.ij blogDB.sql |
| |
| 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'. |
| |
| Now start the blog application (.eba file) you downloaded earlier, by |
| copying it into the load directory which was created when Aries started. |
| |
| Point your browser to [http://localhost:8080/org.apache.aries.samples.blog.web/](http://localhost:8080/org.apache.aries.samples.blog.web/) |
| |
| If you subsequently delete the .eba from the load directory the application |
| will be uninstalled. |
| |
| <a name="BlogSample-0.1-incubating-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/org.apache.aries.samples.blog.web/](http://localhost:8080/org.apache.aries.samples.blog.web/) |
| . 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-0.1-incubating-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-0.1-incubating-AbouttheBlogsample"></a> |
| ## About the Blog sample |
| |
| The blog sample components can be visualised like this: |
| |
| ![bs](BlogSample.png) |