openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r841236 [7/35] - in /websites/staging/openjpa/trunk/content: ./ artifacts/ css/ images/ images/datacache-plugin/
Date Sun, 09 Dec 2012 13:13:50 GMT
Added: websites/staging/openjpa/trunk/content/build-and-runtime-dependencies.html
==============================================================================
--- websites/staging/openjpa/trunk/content/build-and-runtime-dependencies.html (added)
+++ websites/staging/openjpa/trunk/content/build-and-runtime-dependencies.html Sun Dec  9
13:13:35 2012
@@ -0,0 +1,358 @@
+<!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 lang="en">
+    <head>
+        <META http-equiv="Content-Type" content="text/html;charset=UTF-8" />
+        <link href="http://openjpa.apache.org/styles/site.css" rel="stylesheet" type="text/css"/>
+        <!-- <link href="http://openjpa.apache.org/styles/type-settings.css" rel="stylesheet"
type="text/css"/> -->
+        <link href="./css/type-settings.css" rel="stylesheet" type="text/css"/>
+        <LINK rel="schema.DC" href="http://purl.org/DC/elements/1.0/">
+        <META name="Description" content="Apache OpenJPA -- Build and Runtime Dependencies
" />
+        <META name="Keywords" content="Apache OpenJPA, JPA, JPA 1.0, JSR-220, JPA2, JPA
2.0, JSR-317, " />
+        <META name="Owner" content="dev@openjpa.apache.org" />
+        <META name="Robots" content="index, follow" />
+        <META name="Security" content="Public" />
+        <META name="Source" content="wiki template" />
+        <META name="DC.Date" scheme="iso8601" content="2010-08-11" />
+        <META name="DC.Language" scheme="rfc1766" content="en" />
+        <META name="DC.Rights" content="Copyright © 2006,2010 The Apache Software Foundation"
/>
+        <META http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html"
l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r
(n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))'/>
+
+        <title>
+            Apache OpenJPA --
+        </title>
+    </head>
+    <body>
+        <div class="white_box">
+            <div class="header">
+                <div class="header_l">
+                    <div class="header_r">
+                    </div>
+                </div>
+            </div>
+            <div class="content">
+                <div class="content_l">
+                    <div class="content_r">
+                        <div>
+                            <!-- Banner -->
+                            <TABLE valign="top" border="0" cellspacing="0" cellpadding="5"
width="100%" background="images/header-bg3.png">
+                                <TR>
+                                    <TD valing="top" align="left">
+                                        <A href="http://openjpa.apache.org/"><IMG
src="images/openjpa-logo.png" border="0" alt="OpenJPA Logo"></A>
+                                    </TD>
+                                    <TD width="100%">
+                                        &nbsp;
+                                    </TD>
+                                    <TD valing="top" align="right">
+                                        <A href="http://www.apache.org/"><IMG src="images/asf_logo_wide2.png"
border="0" alt="ASF Logo"></A>
+                                    </TD>
+                                </TR>
+                            </TABLE>
+
+                            <!-- Navigation Bar -->
+                            <div class="bottom_red_bar">
+                                <div id="site-breadcrumbs">
+                                    <!-- Breadcrumbs --
+                                    <a href="/">Home</a>&nbsp;&raquo&nbsp;<a
href="/build-and-runtime-dependencies.html">Build and Runtime Dependencies
</a>
+                                     -- Breadcrumbs -->
+                                </div>
+                            </div>
+
+                            <!-- Content -->
+                            <table border="0">
+                                <tbody>
+                                    <tr>
+                                        <td valign="top">
+                                            <div class="navigation">
+                                                <div class="navigation_top">
+                                                    <div class="navigation_bottom">
+                                                        <!-- NavigationBar -->
+                                                        <h3><a name="SideNav-Overview"></a><a
href="overview.html" title="Overview">Overview</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="quick-start.html"
title="Quick Start">Quick Start</a></li>
+                                                            <li><a href="documentation.html"
title="Documentation">Documentation</a></li>
+                                                            <li><a href="downloads.html"
title="Downloads">Downloads</a></li>
+                                                            <li><a href="site-index.html"
title="Site Index">Site Index</a></li>
+                                                            <li><a href="license.html"
title="License">License</a></li>
+                                                            <li><a href="privacy-policy.html"
title="Privacy Policy">Privacy Policy</a></li>
+                                                        </ul>
+
+                                                        <h3><a name="SideNav-Community"></a><a
href="community.html" title="Community">Community</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="index.html#Index-eventsandnews"
title="Events and News">Events and News</a></li>
+                                                            <li><a href="found-a-bug.html"
title="Found a Bug">Found a Bug</a>?</li>
+                                                            <li><a href="get-involved.html"
title="Get Involved">Get Involved</a></li>
+                                                            <li><a href="mailing-lists.html"
title="Mailing Lists">Mailing Lists</a></li>
+                                                            <li><a href="committers.html"
title="Committers">Committers</a></li>
+                                                            <li><a href="integration.html"
title="Integration">Integration</a></li>
+                                                            <li><a href="powered-by.html"
title="Powered By">Powered By</a></li>
+                                                            <li><a href="thanks.html"
title="Thanks">Thanks</a></li>
+                                                        </ul>
+
+
+                                                        <h3><a name="SideNav-Development"></a><a
href="development.html" title="Development">Development</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="http://issues.apache.org/jira/browse/OPENJPA"
class="external-link" rel="nofollow">Issue Tracker</a></li>
+                                                            <li><a href="source-code.html"
title="Source Code">Source Code</a></li>
+                                                            <li><a href="testing.html"
title="Testing">Testing</a></li>
+                                                            <li><a href="tools.html"
title="Tools">Tools</a></li>
+                                                            <li><a href="samples.html"
title="Samples">Samples</a></li>
+                                                            <li><a href="release-management.html"
title="Release Management">Release Management</a></li>
+                                                        </ul>
+
+                                                        <h3>Search</h3>
+
+                                                        <div style="padding: 5px 5px 0px
25px;">
+                                                            <form action="http://www.google.com/search"
method="get" style="font-size: 10px;">
+                                                                <input name="ie" type="hidden"
value="UTF-8">
+                                                                <input name="oe" type="hidden"
value="UTF-8">
+                                                                <input maxlength="255"
name="q" size="9" type="text" value=""><br><br>
+                                                                <input name="btnG" type="submit"
value="Google">
+                                                                <input name="domains"
type="hidden" value="openjpa.apache.org">
+                                                                <input name="sitesearch"
type="hidden" value="openjpa.apache.org">
+                                                            </form>
+                                                        </div>
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </td>
+                                        <td valign="top" width="100%" style="overflow:hidden;">
+                                            <div class="wiki-content">
+                                                <p><a name="OpenJPABuildandRuntimeDependencies></a></p>
+<p><a name="BuildandRuntimeDependencies-Javaversions"></a></p>
+<h2 id="java-versions">Java versions</h2>
+<ul>
+<li>OpenJPA trunk (i.e. OpenJPA 2.2.0 currently) and 2.1.x branch require JDK 1.6.</li>
+<li>OpenJPA 2.0.x branch requires JDK 1.6 or 1.5. Note that some functionality that
requires JDK 1.6 will not be available if you choose to build with JDK 1.5.</li>
+<li>Building javadoc from 2.0.x branch or newer requires JDK 1.6.</li>
+<li>OpenJPA 1.3.x, 1.2.x and 1.1.x branches require JDK 1.5.</li>
+<li>OpenJPA 1.0.x branch requires JDK 1.5 or 1.4.</li>
+</ul>
+<p><a name="BuildandRuntimeDependencies-Mavenversions"></a></p>
+<h2 id="maven-versions">Maven versions</h2>
+<ul>
+<li>Trunk, 2.1.x and 2.0.x branches require Maven 2.2.1.</li>
+<li>1.3.x, 1.2.x, 1.1.x and 1.0.x branches require Maven 2.0.9.</li>
+</ul>
+<p><a name="BuildandRuntimeDependencies-RuntimeDependencies"></a></p>
+<h2 id="runtime-dependencies">Runtime Dependencies</h2>
+<p>The binary release download of OpenJPA
+<em>apache-openjpa-<version>-binary.zip</em> includes all of the code needed
to
+run in a stand-alone Java SE JVM or within a Java EE application server.</p>
+<p><a name="BuildandRuntimeDependencies-OpenJPA1.0.x-1.2.xReleases"></a></p>
+<h3 id="openjpa-10x-12x-releases">OpenJPA 1.0.x - 1.2.x Releases</h3>
+<p>The binary download includes the following required OpenJPA core artifact:</p>
+<ul>
+<li>openjpa-<version>.jar</li>
+</ul>
+<p>and the following required runtime dependencies under the lib/ directory:</p>
+<ul>
+<li>commons-collections-3.2.jar</li>
+<li>commons-lang-2.1.jar</li>
+<li>commons-pool-1.3.jar</li>
+<li>serp-1.13.1.jar</li>
+</ul>
+<p>The following artifacts under lib/ are only required for Java SE
+environments, as a Java EE application server should provide an
+implementation:</p>
+<ul>
+<li>geronimo-jpa_3.0_spec-1.0.jar</li>
+<li>geronimo-jta_1.1_spec-1.1.jar</li>
+</ul>
+<p>The following artifact under lib/ is optional, as you should include the
+JDBC driver artifacts required by your database provider and <a href="http://openjpa.apache.org/builds/1.2.2/apache-openjpa-1.2.2/docs/manual/supported_databases.html#d0e32625">supported</a>
+ by OpenJPA:</p>
+<ul>
+<li>derby-10.2.2.0.jar</li>
+</ul>
+<p><a name="BuildandRuntimeDependencies-OpenJPA1.3.0SNAPSHOTBranch"></a></p>
+<h3 id="openjpa-130-snapshot-branch">OpenJPA 1.3.0 SNAPSHOT Branch</h3>
+<p>The binary download includes the following required OpenJPA core artifact:</p>
+<ul>
+<li>openjpa-<version>.jar</li>
+</ul>
+<p>and the following required runtime dependencies under the lib/ directory:</p>
+<ul>
+<li>commons-collections-3.2.1.jar</li>
+<li>commons-lang-2.1.jar</li>
+<li>commons-pool-1.5.3.jar</li>
+<li>serp-1.13.1.jar</li>
+</ul>
+<p>The following artifacts under lib/ are only required for Java SE
+environments, as a Java EE application server should provide an
+implementation:</p>
+<ul>
+<li>geronimo-jms_1.1_spec-1.1.1.jar</li>
+<li>geronimo-jpa_1.0_spec-1.1.2.jar</li>
+<li>geronimo-jta_1.1_spec-1.1.1.jar</li>
+</ul>
+<p>The following artifact under lib/ is optional, as you should include the
+JDBC driver artifacts required by your database provider and <a href="http://openjpa.apache.org/builds/1.2.2/apache-openjpa-1.2.2/docs/manual/supported_databases.html#d0e32625">supported</a>
+ by OpenJPA:</p>
+<ul>
+<li>derby-10.2.2.0.jar</li>
+</ul>
+<p>The binary download also contains an artifact which includes the OpenJPA
+core code plus all of the runtime dependencies for Java SE environments:</p>
+<ul>
+<li>openjpa-all-<version>.jar</li>
+</ul>
+<p>which in turn includes classes from the following packages:</p>
+<ul>
+<li>commons-collections-3.2.1.jar</li>
+<li>commons-lang-2.1.jar</li>
+<li>commons-logging-1.0.4.jar</li>
+<li>commons-pool-1.5.3.jar</li>
+<li>geronimo-jms_1.1_spec-1.1.1.jar</li>
+<li>geronimo-jpa_1.0_spec-1.1.2.jar</li>
+<li>geronimo-jta_1.1_spec-1.1.1.jar</li>
+<li>serp-1.13.1.jar</li>
+</ul>
+<p><a name="BuildandRuntimeDependencies-OpenJPA2.0.xReleases"></a></p>
+<h3 id="openjpa-20x-releases">OpenJPA 2.0.x Releases</h3>
+<p>The binary download includes the following required OpenJPA core artifact:</p>
+<ul>
+<li>openjpa-<version>.jar</li>
+</ul>
+<p>and the following required runtime dependencies under the lib/ directory:</p>
+<ul>
+<li>commons-collections-3.2.1.jar</li>
+<li>commons-lang-2.1.jar</li>
+<li>commons-pool-1.5.3.jar</li>
+<li>serp-1.13.1.jar</li>
+</ul>
+<p>The following artifacts under lib/ are only required for Java SE
+environments, as a Java EE application server should provide an
+implementation:</p>
+<ul>
+<li>geronimo-jms_1.1_spec-1.1.1.jar</li>
+<li>geronimo-jpa_2.0_spec-1.0.jar</li>
+<li>geronimo-jta_1.1_spec-1.1.1.jar</li>
+</ul>
+<p>The following artifact under lib/ is optional, as you should include the
+JDBC driver artifacts required by your database provider and <a href="http://openjpa.apache.org/builds/2.0.1/apache-openjpa-2.0.1/docs/manual/dbsupport.html#d0e36152">supported</a>
+ by OpenJPA:</p>
+<ul>
+<li>derby-10.5.3.0_1.jar</li>
+</ul>
+<p>The binary download also contains an artifact which includes the OpenJPA
+core code plus all of the runtime dependencies for Java SE environments:</p>
+<ul>
+<li>openjpa-all-<version>.jar</li>
+</ul>
+<p>which in turn includes classes from the following packages:</p>
+<ul>
+<li>commons-collections-3.2.1.jar</li>
+<li>commons-lang-2.1.jar</li>
+<li>commons-logging-1.0.4.jar</li>
+<li>commons-pool-1.5.3.jar</li>
+<li>geronimo-jms_1.1_spec-1.1.1.jar</li>
+<li>geronimo-jpa_2.0_spec-1.0.jar</li>
+<li>geronimo-jta_1.1_spec-1.1.1.jar</li>
+<li>serp-1.13.1.jar</li>
+</ul>
+<p><a name="BuildandRuntimeDependencies-OpenJPA2.1.xReleasesandOpenJPA2.2.0SNAPSHOTBranch"></a></p>
+<h3 id="openjpa-21x-releases-and-openjpa-220-snapshot-branch">OpenJPA 2.1.x Releases
and OpenJPA 2.2.0 SNAPSHOT Branch</h3>
+<p>The binary download includes the following required OpenJPA core artifact:</p>
+<ul>
+<li>openjpa-<version>.jar</li>
+</ul>
+<p>and the following required runtime dependencies under the lib/ directory:</p>
+<ul>
+<li>commons-collections-3.2.1.jar</li>
+<li>commons-lang-2.4.jar</li>
+<li>commons-pool-1.5.4.jar</li>
+<li>serp-1.13.1.jar</li>
+</ul>
+<p>The following artifacts under lib/ are only required for Java SE
+environments, as a Java EE application server should provide an
+implementation:</p>
+<ul>
+<li>geronimo-jms_1.1_spec-1.1.1.jar</li>
+<li>geronimo-jpa_2.0_spec-1.1.jar</li>
+<li>geronimo-jta_1.1_spec-1.1.1.jar</li>
+</ul>
+<p>The following artifact under lib/ is optional, as you should include the
+JDBC driver artifacts required by your database provider and <a href="http://openjpa.apache.org/builds/2.1.1/apache-openjpa/docs/dbsupport.html">supported</a>
+ by OpenJPA:</p>
+<ul>
+<li>derby-10.5.3.0_1.jar</li>
+</ul>
+<p>The following artifacts under lib/ are optional and can be used for bean
+validation:</p>
+<ul>
+<li>commons-beanutils-1.8.3.jar</li>
+<li>org.apache.bval.bundle-0.2-incubating.jar</li>
+</ul>
+<p>The binary download also contains an artifact which includes the OpenJPA
+core code plus all of the runtime dependencies for Java SE environments:</p>
+<ul>
+<li>openjpa-all-<version>.jar</li>
+</ul>
+<p>which in turn includes classes from the following packages:</p>
+<ul>
+<li>commons-beanutils-1.8.3.jar</li>
+<li>commons-collections-3.2.1.jar</li>
+<li>commons-lang-2.4.jar</li>
+<li>commons-logging-1.0.4.jar</li>
+<li>commons-pool-1.5.4.jar</li>
+<li>geronimo-jms_1.1_spec-1.1.1.jar</li>
+<li>geronimo-jpa_2.0_spec-1.1.jar</li>
+<li>geronimo-jta_1.1_spec-1.1.1.jar</li>
+<li>org.apache.bval.bundle-0.2-incubating.jar</li>
+<li>serp-1.13.1.jar</li>
+</ul>
+                                            </div>
+                                        </td>
+                                        </tr>
+                                    </tbody>
+                                </table>
+                                <div class="bottom_red_bar"></div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <div class="black_box">
+                    <div class="footer">
+                        <div class="footer_l">
+                            <div class="footer_r">
+                                <div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <div class="design_attribution">
+                Copyright (C) 2006,2012 The Apache Software Foundation. Licensed under <a
href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a>.<br />
+                Apache, the Apache feather logo and OpenJPA are trademarks of The Apache
Software Foundation.<br />
+                Other names may be trademarks of their respective owners.<br />
+            </div>
+
+        <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
+        </script>
+        <script type="text/javascript">
+            _uacct = "UA-1940143-1";
+            urchinTracker();
+        </script>
+
+    </body>
+</html>

Added: websites/staging/openjpa/trunk/content/building-and-running-openbooks.html
==============================================================================
--- websites/staging/openjpa/trunk/content/building-and-running-openbooks.html (added)
+++ websites/staging/openjpa/trunk/content/building-and-running-openbooks.html Sun Dec  9
13:13:35 2012
@@ -0,0 +1,354 @@
+<!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 lang="en">
+    <head>
+        <META http-equiv="Content-Type" content="text/html;charset=UTF-8" />
+        <link href="http://openjpa.apache.org/styles/site.css" rel="stylesheet" type="text/css"/>
+        <!-- <link href="http://openjpa.apache.org/styles/type-settings.css" rel="stylesheet"
type="text/css"/> -->
+        <link href="./css/type-settings.css" rel="stylesheet" type="text/css"/>
+        <LINK rel="schema.DC" href="http://purl.org/DC/elements/1.0/">
+        <META name="Description" content="Apache OpenJPA -- Building and Running OpenBooks
" />
+        <META name="Keywords" content="Apache OpenJPA, JPA, JPA 1.0, JSR-220, JPA2, JPA
2.0, JSR-317, " />
+        <META name="Owner" content="dev@openjpa.apache.org" />
+        <META name="Robots" content="index, follow" />
+        <META name="Security" content="Public" />
+        <META name="Source" content="wiki template" />
+        <META name="DC.Date" scheme="iso8601" content="2010-08-11" />
+        <META name="DC.Language" scheme="rfc1766" content="en" />
+        <META name="DC.Rights" content="Copyright © 2006,2010 The Apache Software Foundation"
/>
+        <META http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html"
l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r
(n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))'/>
+
+        <title>
+            Apache OpenJPA --
+        </title>
+    </head>
+    <body>
+        <div class="white_box">
+            <div class="header">
+                <div class="header_l">
+                    <div class="header_r">
+                    </div>
+                </div>
+            </div>
+            <div class="content">
+                <div class="content_l">
+                    <div class="content_r">
+                        <div>
+                            <!-- Banner -->
+                            <TABLE valign="top" border="0" cellspacing="0" cellpadding="5"
width="100%" background="images/header-bg3.png">
+                                <TR>
+                                    <TD valing="top" align="left">
+                                        <A href="http://openjpa.apache.org/"><IMG
src="images/openjpa-logo.png" border="0" alt="OpenJPA Logo"></A>
+                                    </TD>
+                                    <TD width="100%">
+                                        &nbsp;
+                                    </TD>
+                                    <TD valing="top" align="right">
+                                        <A href="http://www.apache.org/"><IMG src="images/asf_logo_wide2.png"
border="0" alt="ASF Logo"></A>
+                                    </TD>
+                                </TR>
+                            </TABLE>
+
+                            <!-- Navigation Bar -->
+                            <div class="bottom_red_bar">
+                                <div id="site-breadcrumbs">
+                                    <!-- Breadcrumbs --
+                                    <a href="/">Home</a>&nbsp;&raquo&nbsp;<a
href="/building-and-running-openbooks.html">Building and Running OpenBooks
</a>
+                                     -- Breadcrumbs -->
+                                </div>
+                            </div>
+
+                            <!-- Content -->
+                            <table border="0">
+                                <tbody>
+                                    <tr>
+                                        <td valign="top">
+                                            <div class="navigation">
+                                                <div class="navigation_top">
+                                                    <div class="navigation_bottom">
+                                                        <!-- NavigationBar -->
+                                                        <h3><a name="SideNav-Overview"></a><a
href="overview.html" title="Overview">Overview</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="quick-start.html"
title="Quick Start">Quick Start</a></li>
+                                                            <li><a href="documentation.html"
title="Documentation">Documentation</a></li>
+                                                            <li><a href="downloads.html"
title="Downloads">Downloads</a></li>
+                                                            <li><a href="site-index.html"
title="Site Index">Site Index</a></li>
+                                                            <li><a href="license.html"
title="License">License</a></li>
+                                                            <li><a href="privacy-policy.html"
title="Privacy Policy">Privacy Policy</a></li>
+                                                        </ul>
+
+                                                        <h3><a name="SideNav-Community"></a><a
href="community.html" title="Community">Community</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="index.html#Index-eventsandnews"
title="Events and News">Events and News</a></li>
+                                                            <li><a href="found-a-bug.html"
title="Found a Bug">Found a Bug</a>?</li>
+                                                            <li><a href="get-involved.html"
title="Get Involved">Get Involved</a></li>
+                                                            <li><a href="mailing-lists.html"
title="Mailing Lists">Mailing Lists</a></li>
+                                                            <li><a href="committers.html"
title="Committers">Committers</a></li>
+                                                            <li><a href="integration.html"
title="Integration">Integration</a></li>
+                                                            <li><a href="powered-by.html"
title="Powered By">Powered By</a></li>
+                                                            <li><a href="thanks.html"
title="Thanks">Thanks</a></li>
+                                                        </ul>
+
+
+                                                        <h3><a name="SideNav-Development"></a><a
href="development.html" title="Development">Development</a></h3>
+
+                                                        <ul class="alternate" type="square">
+                                                            <li><a href="http://issues.apache.org/jira/browse/OPENJPA"
class="external-link" rel="nofollow">Issue Tracker</a></li>
+                                                            <li><a href="source-code.html"
title="Source Code">Source Code</a></li>
+                                                            <li><a href="testing.html"
title="Testing">Testing</a></li>
+                                                            <li><a href="tools.html"
title="Tools">Tools</a></li>
+                                                            <li><a href="samples.html"
title="Samples">Samples</a></li>
+                                                            <li><a href="release-management.html"
title="Release Management">Release Management</a></li>
+                                                        </ul>
+
+                                                        <h3>Search</h3>
+
+                                                        <div style="padding: 5px 5px 0px
25px;">
+                                                            <form action="http://www.google.com/search"
method="get" style="font-size: 10px;">
+                                                                <input name="ie" type="hidden"
value="UTF-8">
+                                                                <input name="oe" type="hidden"
value="UTF-8">
+                                                                <input maxlength="255"
name="q" size="9" type="text" value=""><br><br>
+                                                                <input name="btnG" type="submit"
value="Google">
+                                                                <input name="domains"
type="hidden" value="openjpa.apache.org">
+                                                                <input name="sitesearch"
type="hidden" value="openjpa.apache.org">
+                                                            </form>
+                                                        </div>
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </td>
+                                        <td valign="top" width="100%" style="overflow:hidden;">
+                                            <div class="wiki-content">
+                                                <p><a name="BuildingandRunningOpenBooks-InstructionstodownloadandrunOpenBooksDemo"></a></p>
+<h2 id="instructions-to-download-and-run-openbooks-demo">Instructions to download and
run OpenBooks Demo</h2>
+<p>OpenBooks comes with</p>
+<ul>
+<li>complete source code</li>
+<li>build scripts to demonstrate how to build a typical OpenJPA application and package
it for JSE or JEE environment</li>
+<li>scripts to run OpenBooks in on your local database installation.</li>
+</ul>
+<p>Follow the simple instructions below to build and run OpenBooks:</p>
+<p><a name="BuildingandRunningOpenBooks-DownloadInstructions"></a></p>
+<h2 id="download-instructions">Download Instructions</h2>
+<p>OpenBooks can be checked out from OpenJPA repository.</p>
+<p><em>$ svn co</em> <a href="https://svn.apache.org/repos/asf/openjpa/trunk/openjpa-examples/openbooks">https://svn.apache.org/repos/asf/openjpa/trunk/openjpa-examples/openbooks</a>.</p>
+<p>will check out the source code and build scripts of OpenBooks in current
+directory.</p>
+<p>OpenBooks requires following software environment to run:</p>
+<ul>
+<li>Java Runtime version 6.0 or higher</li>
+<li>OpenJPA Libraries version 2.0 or higher</li>
+<li>Ant version 1.6 or higher</li>
+<li>Any JDBC complaint database supported by OpenJPA (embedded Derby is the default).</li>
+</ul>
+<p><a name="BuildingandRunningOpenBooks-Configurebuildandrunenvironment"></a></p>
+<h2 id="configure-build-and-run-environment">Configure build and run environment</h2>
+<p>OpenBooks builds with Ant. The Ant build script is somewhat involved
+because OpenBooks can be built and packaged either as a JSE (Swing based)
+application or a JEE Web Application. By default, OpenBooks is built as a
+JSE application.</p>
+<p>OpenBooks can be built in JSE and JEE mode -- and to keep things simple the
+common build steps are available in main build script <em>build.xml</em> while
+JSE and JEE specific packaging steps are described in separate
+<em>build.jse.xml</em> and <em>build.jee.xml</em>, respectively.
Furthermore, for
+JEE, the deployment step is further refined for each application server.
+See <em>build.jee.was.xml</em> and <em>build.jee.liberty.xml</em>
for build and
+installation steps for WebSphere Application Server and the Liberty Profile
+for WAS, respectively.</p>
+<p>Before you run a build, configure the build environment by editing
+<em>openjpa-examples/openbooks/build.properties</em>. Essentially, you need to</p>
+<ul>
+<li>Point <em>openjpa.lib</em> variable to the local directory where OpenJPA
class
+library(ies) reside. Notice that the variable points to a directory and not
+a <em>*.jar</em> file. All <em>*.jar</em> files found under the directory
are
+included in compilation classpath. OpenJPA version 2.0, however, is also
+available with all its runtime dependencies (such as JPA specification API,
+Apache Commons Collections and others) packaged together in a <em>single</em>
+library (lib).</li>
+</ul>
+<p><em>Note:</em> Access to the OpenJPA class libraries is easier if you
have a
+Maven repository (.m2) available on your system.&nbsp; In this case, all
+that is required is to update the <em>openjpa.version</em> variable to point
at
+the proper OpenJPA SNAPSHOT version.</p>
+<ul>
+<li>Ideally, a JPA-compliant application <em>should</em> not require
+provider-specific library during compilation. OpenBooks persistent domain
+model and application logic also does not use any OpenJPA specific
+features, but OpenJPA libraries are still used during compilation because
+bytecode for persistent entities are <em>enhanced</em> as a post-compilation
step.
+This bytecode enhancement is not essential but an important step for using
+OpenJPA.</li>
+</ul>
+<p>The next step is to configure runtime configuration descriptors and
+environment variables.</p>
+<ul>
+<li>
+<p>JSE</p>
+<ul>
+<li>Edit <em>persistence.xml</em> located in <em>openjpa-examples/openbooks/src/main/resources/META-INF</em>
directory. Modify the <em>javax.persistence.jdbc.driver</em> and <em>javax.persistence.jdbc.url</em>
property to suit your local database and its driver.</li>
+<li>Edit <em>openjpa-examples/openbooks/run.properties</em> to specify
location
+of OpenJPA class libraries and JDBC Driver used in runtime classpath.  Here
+again, the use of the <em>openjpa.version</em> variable with a Maven repository
+makes the library and jdbc driver configuration easy.</li>
+</ul>
+</li>
+<li>
+<p>JEE</p>
+<ul>
+<li>You may already have a JTA data source configured and registered in
+JNDI. Of course, then the appropriate configuration is to be edited
+accordingly in the <em><jta-data-source></em> and <em><non-jta-data-source></em>
+clauses. See <em>persistence.jee.was.xml</em> for WebSphere environment, or *
persistence.jee.liberty.xml* for the Liberty Profile. </li>
+<li>OpenJPA library and JDBC drivers are configured in JEE server and hence
+variables in this file are irrelevant.</li>
+<li>More information on the build and installation of the OpenBooks example
+for application servers can be found in the <a href="#BuildingandRunningOpenBooks-WebSphereApplicationServer">WebSphere
Application Server</a>
+ and <a href="#BuildingandRunningOpenBooks-LibertyProfileinWebSphereApplicationServerv8.5">Liberty
Profile</a>
+ deployment sections.</li>
+</ul>
+</li>
+</ul>
+<p>Both <em>build.properties</em> and <em>run.properties</em>
files are commented
+in-place on what is to be edited.</p>
+<p><a name="BuildingandRunningOpenBooks-BuildOpenBooksfromsource"></a></p>
+<h2 id="build-openbooks-from-source">Build OpenBooks from source</h2>
+<p>Once you have configured the environment, simply issue (from the
+<em>openjpa-examples/openbooks</em> directory):</p>
+<p><em>$ ant</em></p>
+<p>or</p>
+<p><em>$ ant -Dbuild.mode=jee</em></p>
+<p>The default target of the ant script will</p>
+<ul>
+<li>generate metamodel classes (required for Criteria API)</li>
+<li>compile the source code</li>
+<li>enhance the persistence domain model</li>
+<li>package the application based on the build.mode as a Swing-based application or
a Web Application Archive.</li>
+<li>copy the deployable artifacts to <em>target</em> and <em>target/openbooks</em>
directories relative to the current directory.</li>
+</ul>
+<p><a name="BuildingandRunningOpenBooks-DeployOpenBooksinanApplicationServer"></a></p>
+<h2 id="deploy-openbooks-in-an-application-server">Deploy OpenBooks in an Application
Server</h2>
+<p>Deployment techniques and configuration vary across JEE compliant
+application servers. Hence, OpenBooks does not provide an uber-deployment
+script for all application server. Instead, application server specific
+steps are encoded in separate build scripts for each application server.
+Using generic build as described in the previous section, the
+<em>target/openbooks.war</em> web archive needs to be deployed manually.</p>
+<p><a name="BuildingandRunningOpenBooks-WebSphereApplicationServer"></a></p>
+<h3 id="websphere-application-server">WebSphere Application Server</h3>
+<p>For WebSphere Application Server, automated build scripts are available in
+<em>build.jee.was.xml</em>. WebSphere deployment needs to be triggered by
+<em>ws_ant</em> utility as follows</p>
+<p><em>$ ws_ant -Dbuild.mode=jee -Dappserver=was -Dwas.home=&lt;WAS_HOME></em></p>
+<p>where <em>&lt;WAS_HOME></em> denotes the root directory where
WAS V7 with JPA 2.0
+feature pack has been installed (at a minimum). Yes, OpenBooks requires
+features defined by the JPA 2.0 specification, thus the use of the WAS V7
+JPA 2.0 feature pack is a minimum requirement. Further information on this
+feature pack is available <a href="http://www-01.ibm.com/support/docview.wss?rs=180&amp;uid=swg27018836">here</a>
+ or <a href="http://www-01.ibm.com/software/websphere/">WebSphere in general</a>.</p>
+<p>The WebSphere specific build will configure appropriate JTA data sources
+using a python script (found under <em>openbooks/scripts/</em> directory before
+deploying OpenBooks as a web application. The script assumes a single
+server instance. If multiple profiles exist, the script will use the first
+server profile.</p>
+<p><a name="BuildingandRunningOpenBooks-LibertyProfileinWebSphereApplicationServerv8.5"></a></p>
+<h3 id="liberty-profile-in-websphere-application-server-v85">Liberty Profile in WebSphere
Application Server v8.5</h3>
+<p>For the Liberty Profile in WebSphere Application Server v8.5, automated
+build scripts are available in <em>build.jee.liberty.xml</em>. Liberty Profile
+deployment is very easy and needs to be triggered by <em>ant</em> as follows</p>
+<p><em>$ ant -Dbuild.mode=jee -Dappserver=liberty -Dliberty.home=&lt;WAS_HOME>/wlp
-Dliberty.server=&lt;server name></em></p>
+<p>where \&lt;WAS_HOME> denotes the root directory where WAS v8.5 has been
+installed, and <server name> is the name of your Liberty Profile server. 
+Instead of specifying these two variables, <em>liberty.home</em> and
+<em>liberty.server</em>, you could modify the build variables in the
+<em>build.jee.liberty.xml</em> file.<br />
+</p>
+<p>By specifying <em>liberty.home</em> and <em>liberty.server</em>,
the ant script will
+attempt to "deploy" the resulting openbooks.war application to the
+designated Liberty server.  Additional configuration of your Liberty server
+may be required before OpenBooks will work.  For example, you will need to
+specify the <em>jpa-2.0</em> and <em>jdbc-4.0</em> features in your
server.xml.  You
+will also need to define the JTA datasources used by the OpenBooks
+application via your server.xml file.  Examples of a derby configuration
+can be found in the <em>openbooks/scripts/liberty</em> directory.</p>
+<p>Additional information on the Liberty Profile can be found <a href="http://www.wasdev.net/">here</a>
+.  General WebSphere information can be found <a href="http://www-01.ibm.com/software/websphere/">here</a>.</p>
+<p><a name="BuildingandRunningOpenBooks-RunOpenBooks"></a></p>
+<h2 id="run-openbooks">Run OpenBooks</h2>
+<p>If you have built OpenBooks for JSE, then go to the
+<em>openjpa-examples/openbooks/target/openbooks</em> directory.</p>
+<p>Invoke the Ant script to run OpenBooks</p>
+<p><em>$ ant -f run.xml</em></p>
+<p>If you have built OpenBooks for JEE, a Web Application Archive
+<em>openbooks.war</em> will be created in <em>openjpa-examples/openbooks/target</em>
+directory. You need to deploy <em>openbooks.war</em> to a JEE Application
+Server. Once deployed, you can point a browser to Application Server URL</p>
+<p><em>http:// &lt; app server host &gt;:<port>/openbooks/</em></p>
+<p>For example,</p>
+<p><a href="http://localhost:9080/openbooks/">http://localhost:9080/openbooks/</a></p>
+<p>to access OpenBooks as a web application.</p>
+<p><a name="BuildingandRunningOpenBooks-PopulateOpenBooksDatabase"></a></p>
+<h2 id="populate-openbooks-database">Populate OpenBooks Database</h2>
+<p>OpenBooks checks for existing data at first connection to the database. If
+the database is empty, the schema is defined and populated with initial
+data. However, you can explicitly populate the database in JSE build.</p>
+<p><em>Note:</em> By default, the OpenBooks example uses and populates
an Embedded
+Derby instance on "first touch".  So, no further configuration or loading
+is required for the default configuration.</p>
+<p>Edit <em>load.properties</em> to specify load parameters such as number
of Books
+etc. OpenBooks uses this data to populate a database with some sample data.
+This example file has some typical values. If you are satisfied with it,
+you can leave them as it is. Then invoke the Ant script</p>
+<p><em>$ ant -f run.xml load</em></p>
+                                            </div>
+                                        </td>
+                                        </tr>
+                                    </tbody>
+                                </table>
+                                <div class="bottom_red_bar"></div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+                <div class="black_box">
+                    <div class="footer">
+                        <div class="footer_l">
+                            <div class="footer_r">
+                                <div>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <div class="design_attribution">
+                Copyright (C) 2006,2012 The Apache Software Foundation. Licensed under <a
href="http://www.apache.org/licenses/LICENSE-2.0">Apache License 2.0</a>.<br />
+                Apache, the Apache feather logo and OpenJPA are trademarks of The Apache
Software Foundation.<br />
+                Other names may be trademarks of their respective owners.<br />
+            </div>
+
+        <script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
+        </script>
+        <script type="text/javascript">
+            _uacct = "UA-1940143-1";
+            urchinTracker();
+        </script>
+
+    </body>
+</html>



Mime
View raw message