openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mik...@apache.org
Subject svn commit: r1409057 [10/25] - in /openjpa/site: branches/ trunk/ trunk/cgi-bin/ trunk/content/ trunk/content/images/ trunk/lib/ trunk/resources/ trunk/templates/
Date Wed, 14 Nov 2012 01:50:14 GMT
Added: openjpa/site/trunk/content/faq.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/faq.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/faq.mdtext (added)
+++ openjpa/site/trunk/content/faq.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,187 @@
+Title: FAQ
+{excerpt:hidden=true}Frequently Asked Questions about the OpenJPA
+project{excerpt}
+
+<a name="FAQ-FAQ"></a>
+# FAQ
+
+{toc:style=disc|indent=20px|minLevel=2}
+
+<a name="FAQ-General"></a>
+## General
+
+<a name="FAQ-WhatisOpenJPA?"></a>
+### What is OpenJPA?
+
+OpenJPA is a 100% open-source implementation of the Java Persistence API
+(JPA), which is the persistence component for EJB in the [Java EE 5 specification](http://java.sun.com/javaee/)
+.
+
+<a name="FAQ-WhatisthehistoryofOpenJPA?"></a>
+### What is the history of OpenJPA?
+
+OpenJPA has its roots in the popular Kodo product, which was created by
+SolarMetric, Inc. in 2001. BEA Systems, Inc. purchased SolarMetric in
+November of 2005, and soon thereafter [announced](http://dev2dev.bea.com/pub/a/2006/02/interview-kodo-opensource.html)
+ that they would be donating the bulk of the code to the Apache Software
+Foundation. OpenJPA is the result of that donation.
+
+<a name="FAQ-WhatisthecurrentrelationshipbetweenKodoandOpenJPA?"></a>
+### What is the current relationship between Kodo and OpenJPA?
+
+Version 4.1 of Kodo will be based on the OpenJPA code base.
+
+<a name="FAQ-Whatisthecurrentstatusoftheproject?"></a>
+### What is the current status of the project?
+
+OpenJPA is a top-level project at the Apache Software Foundation.
+
+<a name="FAQ-WherecanIdownloadOpenJPA?"></a>
+### Where can I download OpenJPA?
+
+Look at the [Downloads](downloads.html)
+ page.
+
+<a name="FAQ-DoesOpenJPAworkwithmyapplicationserverorcontainer?"></a>
+### Does OpenJPA work with my application server or container?
+
+See [Integration](integration.html)
+.
+
+<a name="FAQ-HowcanIcontributetoOpenJPA?"></a>
+### How can I contribute to OpenJPA?
+
+Check out the [Get Involved](get-involved.html)
+ page.
+
+<a name="FAQ-Technical"></a>
+## Technical
+
+<a name="FAQ-HowdoIfigureoutwhichversionofOpenJPAIamrunning?"></a>
+### How do I figure out which version of OpenJPA I am running?
+
+You can get version number and other details of OpenJPA jar you are using
+by:
+
+
+    
+    h3. How do I see the SQL that OpenJPA is executing?
+    
+    OpenJPA provides configurable channel-based logging, as described in the
+chapter on [Logging|http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_logging]
+. The simplest example of enabling verbose logging is by using the
+following property in your {{persistence.xml}} file:
+    
+    {code:XML}
+    <persistence xmlns="http://java.sun.com/xml/ns/persistence"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        version="1.0">
+        <persistence-unit name="example-logging"
+transaction-type="RESOURCE_LOCAL">
+    	<properties>
+    	    <property name="openjpa.Log" value="SQL=TRACE"/>
+    	</properties>
+        </persistence-unit>
+    </persistence>
+
+
+
+<a name="FAQ-HowdoIenableconnectionpoolinginOpenJPA?"></a>
+### How do I enable connection pooling in OpenJPA?
+
+As of the 2.1.0 release, OpenJPA includes the [Apache DBCP](http://jakarta.apache.org/commons/dbcp/)
+ connection pool. You can also use any third-party connection pool that is
+configurable via the JDBC DataSource API (which most are). The following
+*persistence.xml* example shows how to use OpenJPA with a [Apache Derby|http://db.apache.org/derby/]
+ database and the [Apache DBCP|http://jakarta.apache.org/commons/dbcp/]
+ connection pool:
+
+{code:XML}
+<persistence xmlns="http://java.sun.com/xml/ns/persistence"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    version="1.0">
+    <persistence-unit name="example-derby"
+transaction-type="RESOURCE_LOCAL">
+	<properties>
+	    <property name="openjpa.ConnectionProperties" 
+		value="DriverClassName=org.apache.derby.jdbc.ClientDriver,
+		  Url=jdbc:derby://localhost:1527/database, 
+		  MaxActive=100, 
+		  MaxWait=10000, 
+		  TestOnBorrow=true, 
+		  Username=user, 
+		  Password=secret"/>
+	    <property name="openjpa.ConnectionDriverName" 
+		value="org.apache.commons.dbcp.BasicDataSource"/>
+	</properties>
+    </persistence-unit>
+</persistence>
+
+    
+    See the documentation on [Using a Third-Party DataSource|http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_dbsetup_thirdparty]
+ for further details.
+                                                             
+    h3. Can OpenJPA reorder SQL statements to satisfy database foreign key
+constraints?
+    
+    Yes. OpenJPA can reorder and/or batch the SQL statements using different
+configurable strategies. The default strategy is capable of reordering the
+SQL statements to satisfy foreign key constraints. However ,you must tell
+OpenJPA to read the existing foreign key information from the database
+schema:
+    
+    {code:XML}
+    <property name="openjpa.jdbc.SchemaFactory"
+value="native(ForeignKeys=true)"/>
+
+
+
+See the documentation on [Schema Factory](http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_schema_info_list)
+ for further details.
+
+h3. Why OpenJPA is not creating foreign key constraints on the database
+tables?
+
+By default, OpenJPA does not create foreign key constraints on new tables
+that gets created according to O-R mapping annotation/descriptors. You can
+change this default behavior via following configuration property
+{code:XML}
+<property name="openjpa.jdbc.MappingDefaults"
+value="ForeignKeyDeleteAction=restrict,
+JoinForeignKeyDeleteAction=restrict"/>
+
+    to create foreign key constraints on the database tables generated by
+OpenJPA. 
+    
+    h3. Can OpenJPA map a one-sided one-many association without a cross table?
+    
+    Yes. Standard JPA specification use a cross table to map one-sided
+one-to-many relation without a {{mappedBy}} inverse side. Often, you would
+like to create a one-to-many association based on an inverse foreign key
+(logical or actual) in the table of the related type. OpenJPA supports this
+mapping via {{@ElementJoinColumn}} annotation. The following example will
+map the collection of {{LineItem}} of a {{Subscription}} via a foreign key
+of {{LINEITEM}} table referring to primary key of {{SUBSCRIPTION}} table.
+    {code:JAVA}
+    package org.mag.subscribe;
+    
+    import org.apache.openjpa.persistence.jdbc.*;
+    
+    @Entity
+    public class LineItem {
+        // has no inverse relation to Subscription
+    }
+    
+    @Entity
+    @Table(name="SUB", schema="CNTRCT")
+    public class Subscription {
+        @Id 
+        private long id;
+    
+        @OneToMany
+        @ElementJoinColumn(name="SUB_ID", referencedColumnName="ID")
+        private Collection<LineItem> items;
+    
+        ...
+    }
+

Added: openjpa/site/trunk/content/fetch-statistics
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/fetch-statistics?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/fetch-statistics (added)
+++ openjpa/site/trunk/content/fetch-statistics Wed Nov 14 01:49:37 2012
@@ -0,0 +1,41 @@
+h1. Fetch Statistics
+
+The OpenJPA Fetch Statistics Tool (FST) monitors persistent field access and helps determine which fields in an application are not used. This tool is a development / test time tool that can help a developer properly tune an application.
+
+h2. Note
+
+* Currently, FST only works with runtime enhancement (javaagent or in JEE container hook).
+
+* The persistent fields which satisfy all the following conditions will be tracked :
+** The field is fetched eagerly.
+** The field is not a primary key.
+** The field is not defined as a version field.
+
+h2. Download
+
+The latest OpenJPA FST jar file can be download from the [SNAPSHOT Repository|https://repository.apache.org/content/groups/snapshots/org/apache/openjpa/openjpa-fetch-statistics/] or can be built from the source code in [svn|https://svn.apache.org/repos/asf/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/] by using Maven 2.2.1 and Java SE 6.
+
+h2. Configuration
+ * JSE - Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar file to the classpath prior to lanuching the JVM.
+ * [Websphere Application Server|For Websphere Application Server]
+ * OSGi -- ?? -- Probably need another module that creates a proper bundle.
+
+h2. Statistics Collecting and Monitoring
+{warning:title=Performance Consideration}
+There will be a large performance impact when running this tooling. It is not supported, nor recommended for production use. *This tool should not be used on a production machine.*
+{warning} 
+* When this tool is configured, it will be active for all persistence units in the JVM. Statistics will be dumped via the openjpa.Runtime channel with the INFO level every 10 minutes, or when the JVM terminates. 
+
+{info:title=Example output}
+\[7/13/12 9:05:44:265 CDT\] 00000072 Runtime       I   CWWJP9990I: openjpa.Runtime: Info: Successfully collected fetch statistics from Entities \[org.apache.openjpa.test.Address\]. The following fields are FetchType.EAGER and were never fetched [ total 7 ] : 
+org.apache.openjpa.test.Address.city
+org.apache.openjpa.test.Address.country
+org.apache.openjpa.test.Address.phone
+org.apache.openjpa.test.Address.state
+org.apache.openjpa.test.Address.street1
+org.apache.openjpa.test.Address.street2
+org.apache.openjpa.test.Address.zip
+{info} 
+
+h2. Configuration removal
+* Stop the JVM and reverse the steps completed to configure the tool.
\ No newline at end of file

Added: openjpa/site/trunk/content/fetch-statistics.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/fetch-statistics.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/fetch-statistics.cwiki (added)
+++ openjpa/site/trunk/content/fetch-statistics.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1,41 @@
+h1. Fetch Statistics
+
+The OpenJPA Fetch Statistics Tool (FST) monitors persistent field access and helps determine which fields in an application are not used. This tool is a development / test time tool that can help a developer properly tune an application.
+
+h2. Note
+
+* Currently, FST only works with runtime enhancement (javaagent or in JEE container hook).
+
+* The persistent fields which satisfy all the following conditions will be tracked :
+** The field is fetched eagerly.
+** The field is not a primary key.
+** The field is not defined as a version field.
+
+h2. Download
+
+The latest OpenJPA FST jar file can be download from the [SNAPSHOT Repository|https://repository.apache.org/content/groups/snapshots/org/apache/openjpa/openjpa-fetch-statistics/] or can be built from the source code in [svn|https://svn.apache.org/repos/asf/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/] by using Maven 2.2.1 and Java SE 6.
+
+h2. Configuration
+ * JSE - Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar file to the classpath prior to lanuching the JVM.
+ * [Websphere Application Server|For Websphere Application Server]
+ * OSGi -- ?? -- Probably need another module that creates a proper bundle.
+
+h2. Statistics Collecting and Monitoring
+{warning:title=Performance Consideration}
+There will be a large performance impact when running this tooling. It is not supported, nor recommended for production use. *This tool should not be used on a production machine.*
+{warning} 
+* When this tool is configured, it will be active for all persistence units in the JVM. Statistics will be dumped via the openjpa.Runtime channel with the INFO level every 10 minutes, or when the JVM terminates. 
+
+{info:title=Example output}
+\[7/13/12 9:05:44:265 CDT\] 00000072 Runtime       I   CWWJP9990I: openjpa.Runtime: Info: Successfully collected fetch statistics from Entities \[org.apache.openjpa.test.Address\]. The following fields are FetchType.EAGER and were never fetched [ total 7 ] : 
+org.apache.openjpa.test.Address.city
+org.apache.openjpa.test.Address.country
+org.apache.openjpa.test.Address.phone
+org.apache.openjpa.test.Address.state
+org.apache.openjpa.test.Address.street1
+org.apache.openjpa.test.Address.street2
+org.apache.openjpa.test.Address.zip
+{info} 
+
+h2. Configuration removal
+* Stop the JVM and reverse the steps completed to configure the tool.
\ No newline at end of file

Propchange: openjpa/site/trunk/content/fetch-statistics.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/fetch-statistics.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/fetch-statistics.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/fetch-statistics.mdtext (added)
+++ openjpa/site/trunk/content/fetch-statistics.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,65 @@
+Title: Fetch Statistics
+<a name="FetchStatistics-FetchStatistics"></a>
+# Fetch Statistics
+
+The OpenJPA Fetch Statistics Tool (FST) monitors persistent field access
+and helps determine which fields in an application are not used. This tool
+is a development / test time tool that can help a developer properly tune
+an application.
+
+<a name="FetchStatistics-Note"></a>
+## Note
+
+* Currently, FST only works with runtime enhancement (javaagent or in JEE
+container hook).
+
+* The persistent fields which satisfy all the following conditions will be
+tracked :
+** The field is fetched eagerly.
+** The field is not a primary key.
+** The field is not defined as a version field.
+
+<a name="FetchStatistics-Download"></a>
+## Download
+
+The latest OpenJPA FST jar file can be download from the [SNAPSHOT Repository](https://repository.apache.org/content/groups/snapshots/org/apache/openjpa/openjpa-fetch-statistics/)
+ or can be built from the source code in [svn|https://svn.apache.org/repos/asf/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/]
+ by using Maven 2.2.1 and Java SE 6.
+
+<a name="FetchStatistics-Configuration"></a>
+## Configuration
+ * JSE - Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar
+file to the classpath prior to lanuching the JVM.
+ * [Websphere Application Server](for-websphere-application-server.html)
+ * OSGi -- ?? -- Probably need another module that creates a proper bundle.
+
+<a name="FetchStatistics-StatisticsCollectingandMonitoring"></a>
+## Statistics Collecting and Monitoring
+{warning:title=Performance Consideration}
+There will be a large performance impact when running this tooling. It is
+not supported, nor recommended for production use. *This tool should not be
+used on a production machine.*
+{warning} 
+* When this tool is configured, it will be active for all persistence units
+in the JVM. Statistics will be dumped via the openjpa.Runtime channel with
+the INFO level every 10 minutes, or when the JVM terminates. 
+
+{info:title=Example output}
+\[7/13/12 9:05:44:265 CDT\](7/13/12-9:05:44:265-cdt\.html)
+ 00000072 Runtime	I   CWWJP9990I: openjpa.Runtime: Info: Successfully
+collected fetch statistics from Entities
+\[org.apache.openjpa.test.Address\]. The following fields are
+FetchType.EAGER and were never fetched [ total 7 ]
+ : 
+org.apache.openjpa.test.Address.city
+org.apache.openjpa.test.Address.country
+org.apache.openjpa.test.Address.phone
+org.apache.openjpa.test.Address.state
+org.apache.openjpa.test.Address.street1
+org.apache.openjpa.test.Address.street2
+org.apache.openjpa.test.Address.zip
+{info} 
+
+<a name="FetchStatistics-Configurationremoval"></a>
+## Configuration removal
+* Stop the JVM and reverse the steps completed to configure the tool.

Added: openjpa/site/trunk/content/findbugs-presentation-notes
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/findbugs-presentation-notes?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/findbugs-presentation-notes (added)
+++ openjpa/site/trunk/content/findbugs-presentation-notes Wed Nov 14 01:49:37 2012
@@ -0,0 +1,36 @@
+Bill Pugh
+
+(side note: compiling with "-target jsr14" will allow us to use generics and compile to JDK 1.4 usable code)
+
+Static analysis
+    Analyzes program w/out executing
+    Not a replacement for testing
+
+Find bugs that are one step removed from a syntax error
+
+Finding different categories of problems
+
+"Embrace and fix your dumb mistakes"
+
+Bad method calls: not using return parameters, not throwing newly constructed exceptions,
+ etc.
+
+OpenJPA 38 issues (35 critical)
+
+Checks for null when subsequent actions would cause an NPE (numerous found in OpenJPA)
+
+Bad practices, like hashCode() w/out equals()
+
+Feedback about API-specific findbugs detectors (e.g., for JPA) would be appreciated
+
+OpenJPA is "good" to "average" in the number of bugs found.
+
+OpenJPA:
+
+ SimpleDateFormat is not thread-safe
+
+
+
+
+
+

Added: openjpa/site/trunk/content/findbugs-presentation-notes.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/findbugs-presentation-notes.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/findbugs-presentation-notes.cwiki (added)
+++ openjpa/site/trunk/content/findbugs-presentation-notes.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1,36 @@
+Bill Pugh
+
+(side note: compiling with "-target jsr14" will allow us to use generics and compile to JDK 1.4 usable code)
+
+Static analysis
+    Analyzes program w/out executing
+    Not a replacement for testing
+
+Find bugs that are one step removed from a syntax error
+
+Finding different categories of problems
+
+"Embrace and fix your dumb mistakes"
+
+Bad method calls: not using return parameters, not throwing newly constructed exceptions,
+ etc.
+
+OpenJPA 38 issues (35 critical)
+
+Checks for null when subsequent actions would cause an NPE (numerous found in OpenJPA)
+
+Bad practices, like hashCode() w/out equals()
+
+Feedback about API-specific findbugs detectors (e.g., for JPA) would be appreciated
+
+OpenJPA is "good" to "average" in the number of bugs found.
+
+OpenJPA:
+
+ SimpleDateFormat is not thread-safe
+
+
+
+
+
+

Propchange: openjpa/site/trunk/content/findbugs-presentation-notes.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/findbugs-presentation-notes.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/findbugs-presentation-notes.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/findbugs-presentation-notes.mdtext (added)
+++ openjpa/site/trunk/content/findbugs-presentation-notes.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,41 @@
+Title: FindBugs Presentation Notes
+Bill Pugh
+
+(side note: compiling with "-target jsr14" will allow us to use generics
+and compile to JDK 1.4 usable code)
+
+Static analysis
+    Analyzes program w/out executing
+    Not a replacement for testing
+
+Find bugs that are one step removed from a syntax error
+
+Finding different categories of problems
+
+"Embrace and fix your dumb mistakes"
+
+Bad method calls: not using return parameters, not throwing newly
+constructed exceptions,
+ etc.
+
+OpenJPA 38 issues (35 critical)
+
+Checks for null when subsequent actions would cause an NPE (numerous found
+in OpenJPA)
+
+Bad practices, like hashCode() w/out equals()
+
+Feedback about API-specific findbugs detectors (e.g., for JPA) would be
+appreciated
+
+OpenJPA is "good" to "average" in the number of bugs found.
+
+OpenJPA:
+
+ SimpleDateFormat is not thread-safe
+
+
+
+
+
+

Added: openjpa/site/trunk/content/found-a-bug
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/found-a-bug?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/found-a-bug (added)
+++ openjpa/site/trunk/content/found-a-bug Wed Nov 14 01:49:37 2012
@@ -0,0 +1,37 @@
+{excerpt:hidden=true}How to report a bug you find in OpenJPA{excerpt}
+
+h2. Found a Bug?
+
+If you think you've found a problem with OpenJPA, there are several ways to proceed.
+
+You can begin by raising the issue on the OpenJPA User or Developer mailing lists (see [Mailing Lists]).
+
+You can also search JIRA, our issue-tracking system, to see if the problem has already been noted (visit [JIRA|http://issues.apache.org/jira/browse/OPENJPA]). If the issue is not listed there, you can add a new JIRA issue describing it. Please include detailed steps to reproduce the problem.
+
+If you have a fix for the issue, you can generate a patch file to send the fix to us. You need to check out the current source code from Subversion (see [Source Code]), make the necessary changes (see [Coding Standards]), and then do a full build with all tests enabled (see [Building]) and make sure the unit tests runs as expected (try {{maven clean install}} to run a full build), and of course, confirm that the problem is actually fixed. Then, go to the root directory of your OpenJPA checkout, and run a command like {{svn diff > OPENJPA-<JIRA_NUMBER>-<BRANCH_ID>.patch}} to generate a patch file.
+
+To submit a patch, create an issue in JIRA that describes the problem, add your patch file as an attachment (don't forget to select the "Grant license to ASF for inclusion in ASF works" option), and then edit the JIRA to select the [Patch Available|https://issues.apache.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12313253] check box.  Please include detailed steps to reproduce the problem in the issue description, and a test case in the patch where possible (see [Testing]).
+
+For larger contributions, like new features or more complex bug fixes, you should also have an [Individual Contributor License Agreement|http://www.apache.org/licenses/#clas] on file with the ASF.
+
+
+Thanks for working with us to improve Apache OpenJPA!
+
+h2. Reporting Security Vulnerabilities
+
+The Apache Software Foundation takes a very active stance in eliminating security problems and denial of service attacks against the code we provide.
+
+We strongly encourage folks to report any such problems discovered in OpenJPA to our private PMC mailing list [mailto:private@openjpa.apache.org] first, before disclosing them in a public forum.
+
+Please note that the private PMC mailing list should only be used for reporting undisclosed security vulnerabilities and managing the process of fixing such vulnerabilities until they are made public. We will not accept regular bug reports or other general user queries at this address.
+
+If you need to report a bug that is already a disclosed security vulnerability, please use the regular bug reporting process above.
+
+Questions about:
+* how to securely configure OpenJPA
+* if a vulnerability applies to your particular application or OpenJPA level
+* obtaining further information on a published vulnerability
+* availability of patches and/or new releases
+
+should be address to the users mailing list. Please see the [Mailing Lists] page for details of how to subscribe.
+

Added: openjpa/site/trunk/content/found-a-bug.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/found-a-bug.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/found-a-bug.cwiki (added)
+++ openjpa/site/trunk/content/found-a-bug.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1,37 @@
+{excerpt:hidden=true}How to report a bug you find in OpenJPA{excerpt}
+
+h2. Found a Bug?
+
+If you think you've found a problem with OpenJPA, there are several ways to proceed.
+
+You can begin by raising the issue on the OpenJPA User or Developer mailing lists (see [Mailing Lists]).
+
+You can also search JIRA, our issue-tracking system, to see if the problem has already been noted (visit [JIRA|http://issues.apache.org/jira/browse/OPENJPA]). If the issue is not listed there, you can add a new JIRA issue describing it. Please include detailed steps to reproduce the problem.
+
+If you have a fix for the issue, you can generate a patch file to send the fix to us. You need to check out the current source code from Subversion (see [Source Code]), make the necessary changes (see [Coding Standards]), and then do a full build with all tests enabled (see [Building]) and make sure the unit tests runs as expected (try {{maven clean install}} to run a full build), and of course, confirm that the problem is actually fixed. Then, go to the root directory of your OpenJPA checkout, and run a command like {{svn diff > OPENJPA-<JIRA_NUMBER>-<BRANCH_ID>.patch}} to generate a patch file.
+
+To submit a patch, create an issue in JIRA that describes the problem, add your patch file as an attachment (don't forget to select the "Grant license to ASF for inclusion in ASF works" option), and then edit the JIRA to select the [Patch Available|https://issues.apache.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12313253] check box.  Please include detailed steps to reproduce the problem in the issue description, and a test case in the patch where possible (see [Testing]).
+
+For larger contributions, like new features or more complex bug fixes, you should also have an [Individual Contributor License Agreement|http://www.apache.org/licenses/#clas] on file with the ASF.
+
+
+Thanks for working with us to improve Apache OpenJPA!
+
+h2. Reporting Security Vulnerabilities
+
+The Apache Software Foundation takes a very active stance in eliminating security problems and denial of service attacks against the code we provide.
+
+We strongly encourage folks to report any such problems discovered in OpenJPA to our private PMC mailing list [mailto:private@openjpa.apache.org] first, before disclosing them in a public forum.
+
+Please note that the private PMC mailing list should only be used for reporting undisclosed security vulnerabilities and managing the process of fixing such vulnerabilities until they are made public. We will not accept regular bug reports or other general user queries at this address.
+
+If you need to report a bug that is already a disclosed security vulnerability, please use the regular bug reporting process above.
+
+Questions about:
+* how to securely configure OpenJPA
+* if a vulnerability applies to your particular application or OpenJPA level
+* obtaining further information on a published vulnerability
+* availability of patches and/or new releases
+
+should be address to the users mailing list. Please see the [Mailing Lists] page for details of how to subscribe.
+

Propchange: openjpa/site/trunk/content/found-a-bug.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/found-a-bug.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/found-a-bug.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/found-a-bug.mdtext (added)
+++ openjpa/site/trunk/content/found-a-bug.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,73 @@
+Title: Found a Bug
+{excerpt:hidden=true}How to report a bug you find in OpenJPA{excerpt}
+
+<a name="FoundaBug-FoundaBug?"></a>
+## Found a Bug?
+
+If you think you've found a problem with OpenJPA, there are several ways to
+proceed.
+
+You can begin by raising the issue on the OpenJPA User or Developer mailing
+lists (see [Mailing Lists](mailing-lists.html)
+).
+
+You can also search JIRA, our issue-tracking system, to see if the problem
+has already been noted (visit [JIRA](http://issues.apache.org/jira/browse/OPENJPA)
+). If the issue is not listed there, you can add a new JIRA issue
+describing it. Please include detailed steps to reproduce the problem.
+
+If you have a fix for the issue, you can generate a patch file to send the
+fix to us. You need to check out the current source code from Subversion
+(see [Source Code](source-code.html)
+), make the necessary changes (see [Coding Standards]
+), and then do a full build with all tests enabled (see [Building]
+) and make sure the unit tests runs as expected (try {{maven clean
+install}} to run a full build), and of course, confirm that the problem is
+actually fixed. Then, go to the root directory of your OpenJPA checkout,
+and run a command like {{svn diff >
+OPENJPA-<JIRA_NUMBER>-<BRANCH_ID>.patch}} to generate a patch file.
+
+To submit a patch, create an issue in JIRA that describes the problem, add
+your patch file as an attachment (don't forget to select the "Grant license
+to ASF for inclusion in ASF works" option), and then edit the JIRA to
+select the [Patch Available](https://issues.apache.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12313253)
+ check box.  Please include detailed steps to reproduce the problem in the
+issue description, and a test case in the patch where possible (see [Testing]
+).
+
+For larger contributions, like new features or more complex bug fixes, you
+should also have an [Individual Contributor License Agreement](http://www.apache.org/licenses/#clas)
+ on file with the ASF.
+
+
+Thanks for working with us to improve Apache OpenJPA!
+
+<a name="FoundaBug-ReportingSecurityVulnerabilities"></a>
+## Reporting Security Vulnerabilities
+
+The Apache Software Foundation takes a very active stance in eliminating
+security problems and denial of service attacks against the code we
+provide.
+
+We strongly encourage folks to report any such problems discovered in
+OpenJPA to our private PMC mailing list [mailto:private@openjpa.apache.org](mailto:private@openjpa.apache.org.html)
+ first, before disclosing them in a public forum.
+
+Please note that the private PMC mailing list should only be used for
+reporting undisclosed security vulnerabilities and managing the process of
+fixing such vulnerabilities until they are made public. We will not accept
+regular bug reports or other general user queries at this address.
+
+If you need to report a bug that is already a disclosed security
+vulnerability, please use the regular bug reporting process above.
+
+Questions about:
+* how to securely configure OpenJPA
+* if a vulnerability applies to your particular application or OpenJPA
+level
+* obtaining further information on a published vulnerability
+* availability of patches and/or new releases
+
+should be address to the users mailing list. Please see the [Mailing Lists](mailing-lists.html)
+ page for details of how to subscribe.
+

Added: openjpa/site/trunk/content/get-involved
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/get-involved?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/get-involved (added)
+++ openjpa/site/trunk/content/get-involved Wed Nov 14 01:49:37 2012
@@ -0,0 +1,38 @@
+{excerpt:hidden=true}Information on getting involved with the OpenJPA project{excerpt}
+
+h2. Join the Apache OpenJPA Community
+
+The Apache OpenJPA project is being built by the open source community for the open source community - we welcome your input and contributions!
+
+h3. What we are looking for
+
+ * Source code and fixes contributions
+ * Test cases for issues encountered during application development 
+ * Documentation assistance
+ * Product and feature suggestions
+ * Detailed and constructive feedback
+ * Articles and whitepapers
+
+h3. How do I Contribute?
+
+ * To discuss Apache OpenJPA topics check out the [mailing lists].
+ * Bugs and other issues can be posted on the project [JIRA|http://issues.apache.org/jira/browse/OPENJPA].
+
+h3. I have encountered an issue with OpenJPA. What do I do now?
+
+  * Post a message to OpenJPA User's list to discuss the issue.
+  * Search existing [issues|http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&pid=12310351] to see whether someone had already encountered the same issue.
+  * If this issue is never encountered before, create a [JIRA issue|http://issues.apache.org/jira/browse/OPENJPA].
+  * Develop a test case to demonstrate the issue.  Here are some [useful tips and guidelines|Writing Test Cases For OpenJPA] on how to develop a test case to contribute to OpenJPA repository. 
+  * Attach the new test to JIRA issue. 
+  * Check out the [Found a Bug] page for more details on creating and submitting patches.
+
+h3. I have encountered an issue with OpenJPA and have fixed it in the OpenJPA source code. How do I get the changes into OpenJPA?
+ * Create a [JIRA issue|http://issues.apache.org/jira/browse/OPENJPA] that describes the changes you've made (you'll need an Apache JIRA account to do this).
+ * Check out the OpenJPA source code and make your changes. 
+ * Create test cases to validate your changes. Here are some [useful tips and guidelines|Writing Test Cases For OpenJPA] on how to develop a test case to contribute to OpenJPA repository. 
+ * {{'svn add'}} any new files.
+ * Run {{'mvn test -Dtest=<MyTestCase>'}} to validate your change. You need to specify the test to run by its simple name without package name.
+ * Run the checkin tests by running {{'mvn test'}} for any possible regression. This should take 20-50 minutes or so depending on the release branch.
+ * Check out the [Found a Bug] page for more details on creating and submitting patches.
+ * Wait for a committer to review and check in your changes.

Added: openjpa/site/trunk/content/get-involved.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/get-involved.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/get-involved.cwiki (added)
+++ openjpa/site/trunk/content/get-involved.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1,38 @@
+{excerpt:hidden=true}Information on getting involved with the OpenJPA project{excerpt}
+
+h2. Join the Apache OpenJPA Community
+
+The Apache OpenJPA project is being built by the open source community for the open source community - we welcome your input and contributions!
+
+h3. What we are looking for
+
+ * Source code and fixes contributions
+ * Test cases for issues encountered during application development 
+ * Documentation assistance
+ * Product and feature suggestions
+ * Detailed and constructive feedback
+ * Articles and whitepapers
+
+h3. How do I Contribute?
+
+ * To discuss Apache OpenJPA topics check out the [mailing lists].
+ * Bugs and other issues can be posted on the project [JIRA|http://issues.apache.org/jira/browse/OPENJPA].
+
+h3. I have encountered an issue with OpenJPA. What do I do now?
+
+  * Post a message to OpenJPA User's list to discuss the issue.
+  * Search existing [issues|http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&pid=12310351] to see whether someone had already encountered the same issue.
+  * If this issue is never encountered before, create a [JIRA issue|http://issues.apache.org/jira/browse/OPENJPA].
+  * Develop a test case to demonstrate the issue.  Here are some [useful tips and guidelines|Writing Test Cases For OpenJPA] on how to develop a test case to contribute to OpenJPA repository. 
+  * Attach the new test to JIRA issue. 
+  * Check out the [Found a Bug] page for more details on creating and submitting patches.
+
+h3. I have encountered an issue with OpenJPA and have fixed it in the OpenJPA source code. How do I get the changes into OpenJPA?
+ * Create a [JIRA issue|http://issues.apache.org/jira/browse/OPENJPA] that describes the changes you've made (you'll need an Apache JIRA account to do this).
+ * Check out the OpenJPA source code and make your changes. 
+ * Create test cases to validate your changes. Here are some [useful tips and guidelines|Writing Test Cases For OpenJPA] on how to develop a test case to contribute to OpenJPA repository. 
+ * {{'svn add'}} any new files.
+ * Run {{'mvn test -Dtest=<MyTestCase>'}} to validate your change. You need to specify the test to run by its simple name without package name.
+ * Run the checkin tests by running {{'mvn test'}} for any possible regression. This should take 20-50 minutes or so depending on the release branch.
+ * Check out the [Found a Bug] page for more details on creating and submitting patches.
+ * Wait for a committer to review and check in your changes.

Propchange: openjpa/site/trunk/content/get-involved.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/get-involved.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/get-involved.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/get-involved.mdtext (added)
+++ openjpa/site/trunk/content/get-involved.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,59 @@
+Title: Get Involved
+{excerpt:hidden=true}Information on getting involved with the OpenJPA
+project{excerpt}
+
+<a name="GetInvolved-JointheApacheOpenJPACommunity"></a>
+## Join the Apache OpenJPA Community
+
+The Apache OpenJPA project is being built by the open source community for
+the open source community - we welcome your input and contributions!
+
+<a name="GetInvolved-Whatwearelookingfor"></a>
+### What we are looking for
+
+ * Source code and fixes contributions
+ * Test cases for issues encountered during application development 
+ * Documentation assistance
+ * Product and feature suggestions
+ * Detailed and constructive feedback
+ * Articles and whitepapers
+
+<a name="GetInvolved-HowdoIContribute?"></a>
+### How do I Contribute?
+
+ * To discuss Apache OpenJPA topics check out the [mailing lists](mailing-lists.html)
+.
+ * Bugs and other issues can be posted on the project [JIRA](http://issues.apache.org/jira/browse/OPENJPA)
+.
+
+<a name="GetInvolved-IhaveencounteredanissuewithOpenJPA.WhatdoIdonow?"></a>
+### I have encountered an issue with OpenJPA. What do I do now?
+
+  * Post a message to OpenJPA User's list to discuss the issue.
+  * Search existing [issues](http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&pid=12310351)
+ to see whether someone had already encountered the same issue.
+  * If this issue is never encountered before, create a [JIRA issue](http://issues.apache.org/jira/browse/OPENJPA)
+.
+  * Develop a test case to demonstrate the issue.  Here are some [useful tips and guidelines](writing-test-cases-for-openjpa.html)
+ on how to develop a test case to contribute to OpenJPA repository. 
+  * Attach the new test to JIRA issue. 
+  * Check out the [Found a Bug](found-a-bug.html)
+ page for more details on creating and submitting patches.
+
+h3. I have encountered an issue with OpenJPA and have fixed it in the
+OpenJPA source code. How do I get the changes into OpenJPA?
+ * Create a [JIRA issue](http://issues.apache.org/jira/browse/OPENJPA)
+ that describes the changes you've made (you'll need an Apache JIRA account
+to do this).
+ * Check out the OpenJPA source code and make your changes. 
+ * Create test cases to validate your changes. Here are some [useful tips and guidelines](writing-test-cases-for-openjpa.html)
+ on how to develop a test case to contribute to OpenJPA repository. 
+ * *'svn add'* any new files.
+ * Run *'mvn test -Dtest=<MyTestCase>'* to validate your change. You need
+to specify the test to run by its simple name without package name.
+ * Run the checkin tests by running *'mvn test'* for any possible
+regression. This should take 20-50 minutes or so depending on the release
+branch.
+ * Check out the [Found a Bug](found-a-bug.html)
+ page for more details on creating and submitting patches.
+ * Wait for a committer to review and check in your changes.

Added: openjpa/site/trunk/content/getting-started
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/getting-started?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/getting-started (added)
+++ openjpa/site/trunk/content/getting-started Wed Nov 14 01:49:37 2012
@@ -0,0 +1,45 @@
+h3. Notes
+These instructions detail the steps required to run a give sample for a number of different environments. You can substitute any of the directories in the \[binary download\]\examples\ directory for *hellojpa* in the instructions below to run a different sample.
+
+h3. Getting Started with the Eclipse
+
+# Download the OpenJPA binary release from the [downloads] page and unpack it by double-clicking it.
+# Launch Eclipse (this sample was tested with Eclipse 3.2.1, but any recent version should work).
+# Select the *File* menu, traverse to the *New* sub-menu, and select *Project*.
+# On the *Select a wizard* page, select *Java Project from Existing Ant Buildfile*, then click the *Next* button.
+# Hit the *Browse* button next to the *Ant Buildfile* field, and navigate to the unpacked OpenJPA zip file on the desktop, then traverse through *examples*, then *hellojpa*, and select the *build.xml* file and hit the *Open* button.
+# Hit the *Finish* button on the wizard.
+# A new project will open, containing the OpenJPA jar and all its dependencies.
+# On the *Package Explorer*, expand the top-level folder, then the *examples* folder, then *hellojpa*.
+# Select the *build.xml* file in the *hellojpa* folder (note that there is also a *build.xml* file in the parent folder, which should not be selected). Right-click the *build.xml* file, and select the *Run As* sub-menu, then select *Ant Build*.
+# The database will be initialized (using the stand-alone Derby database, which is included with the OpenJPA distribution) and the *Main.java* class will be run. In the *Console*, you should see the text _Hello Persistence!_.
+# Congratulations! You have run your first sample program using OpenJPA. Examine the *Main.java* example program, as well as the *Message.java* entity class, play with them by adding fields and working on new persistence operations. Have fun!
+
+h3. Getting Started with the Console
+
+# Ensure that you have [Apache Ant|http://ant.apache.org/] installed (this sample was tested with ant 1.6.5, but any recent version should work).
+# Download the OpenJPA binary release from the [downloads] page and unpack it by double-clicking it.
+# Launch a console, such as *cmd.exe* on Windows, *Terminal.app* on Mac, or *xterm* on UNIX.
+# Change directories to the Desktop, then cd to the unpacked OpenJPA folder.
+# cd to the *examples* subdirectory, then to the *hellojpa* subdirectory.
+# Run *ant*, which will compile the classes and run the sample application. At the end of the build, you should see the text _Hello Persistence!_.
+# Congratulations! You have run your first sample program using OpenJPA. Examine the *Main.java* example program, as well as the *Message.java* entity class, play with them by adding fields and working on new persistence operations. Have fun!
+
+h3. Getting Started with Netbeans
+
+# Download the OpenJPA binary release from the [downloads] page and unpack it by double-clicking it.
+# Launch Netbeans (this sample was tested with Netbeans 5.5, but any recent version should work).
+# Select the *File* menu and select *New Project*.
+# On the *New Project* page, select Category:*General* Projects:*Java Project with Existing Ant Script*, then click the *Next* button.
+# Press the *Browse* button next to the *Location* field, and navigate to the unpacked OpenJPA directory
+# Press the *Browse* button next to the *Build Script* field, and navigate to the unpacked OpenJPA directory through *examples*, then *hellojpa*, and select the *build.xml* file and press the *Open* button.
+# Type a name for the project, press *Set as Main Project* and press the *Next* button on the wizard.
+# Press *Next* to accept the *Build and Run Actions*.
+# On the *Source Package Folders* page, press *Add Folder*, select the *examples* folder, and press *Next*.
+# On the *Java Sources Classpath* page, press *Add JAR/Folder* and select the openjpa-x.x.x/lib/geronimo-jpa_3.0_spec-1.0.jar which contains the JPA API classes which is used to compile against.
+# Press *Finish*
+# A new project will open, containing the OpenJPA jar and the examples source files.
+# On the *Package Explorer*, expand the top-level folder, then the *examples* folder, then *hellojpa*.
+# Navigate to the *build.xml* file in the *hellojpa* folder (note that there is also a *build.xml* file in the parent folder, which should not be used). Right-click the *build.xml* file, and select the *Run Target* sub-menu, then select *run*.
+# The database will be initialized (using the stand-alone Derby database, which is included with the OpenJPA distribution) and the *Main.java* class will be run. In the *Console*, you should see the text _Hello Persistence!_.
+# Congratulations! You have run your first sample program using OpenJPA. Examine the *Main.java* example program, as well as the *Message.java* entity class, play with them by adding fields and working on new persistence operations. Have fun!
\ No newline at end of file

Added: openjpa/site/trunk/content/getting-started.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/getting-started.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/getting-started.cwiki (added)
+++ openjpa/site/trunk/content/getting-started.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1,45 @@
+h3. Notes
+These instructions detail the steps required to run a give sample for a number of different environments. You can substitute any of the directories in the \[binary download\]\examples\ directory for *hellojpa* in the instructions below to run a different sample.
+
+h3. Getting Started with the Eclipse
+
+# Download the OpenJPA binary release from the [downloads] page and unpack it by double-clicking it.
+# Launch Eclipse (this sample was tested with Eclipse 3.2.1, but any recent version should work).
+# Select the *File* menu, traverse to the *New* sub-menu, and select *Project*.
+# On the *Select a wizard* page, select *Java Project from Existing Ant Buildfile*, then click the *Next* button.
+# Hit the *Browse* button next to the *Ant Buildfile* field, and navigate to the unpacked OpenJPA zip file on the desktop, then traverse through *examples*, then *hellojpa*, and select the *build.xml* file and hit the *Open* button.
+# Hit the *Finish* button on the wizard.
+# A new project will open, containing the OpenJPA jar and all its dependencies.
+# On the *Package Explorer*, expand the top-level folder, then the *examples* folder, then *hellojpa*.
+# Select the *build.xml* file in the *hellojpa* folder (note that there is also a *build.xml* file in the parent folder, which should not be selected). Right-click the *build.xml* file, and select the *Run As* sub-menu, then select *Ant Build*.
+# The database will be initialized (using the stand-alone Derby database, which is included with the OpenJPA distribution) and the *Main.java* class will be run. In the *Console*, you should see the text _Hello Persistence!_.
+# Congratulations! You have run your first sample program using OpenJPA. Examine the *Main.java* example program, as well as the *Message.java* entity class, play with them by adding fields and working on new persistence operations. Have fun!
+
+h3. Getting Started with the Console
+
+# Ensure that you have [Apache Ant|http://ant.apache.org/] installed (this sample was tested with ant 1.6.5, but any recent version should work).
+# Download the OpenJPA binary release from the [downloads] page and unpack it by double-clicking it.
+# Launch a console, such as *cmd.exe* on Windows, *Terminal.app* on Mac, or *xterm* on UNIX.
+# Change directories to the Desktop, then cd to the unpacked OpenJPA folder.
+# cd to the *examples* subdirectory, then to the *hellojpa* subdirectory.
+# Run *ant*, which will compile the classes and run the sample application. At the end of the build, you should see the text _Hello Persistence!_.
+# Congratulations! You have run your first sample program using OpenJPA. Examine the *Main.java* example program, as well as the *Message.java* entity class, play with them by adding fields and working on new persistence operations. Have fun!
+
+h3. Getting Started with Netbeans
+
+# Download the OpenJPA binary release from the [downloads] page and unpack it by double-clicking it.
+# Launch Netbeans (this sample was tested with Netbeans 5.5, but any recent version should work).
+# Select the *File* menu and select *New Project*.
+# On the *New Project* page, select Category:*General* Projects:*Java Project with Existing Ant Script*, then click the *Next* button.
+# Press the *Browse* button next to the *Location* field, and navigate to the unpacked OpenJPA directory
+# Press the *Browse* button next to the *Build Script* field, and navigate to the unpacked OpenJPA directory through *examples*, then *hellojpa*, and select the *build.xml* file and press the *Open* button.
+# Type a name for the project, press *Set as Main Project* and press the *Next* button on the wizard.
+# Press *Next* to accept the *Build and Run Actions*.
+# On the *Source Package Folders* page, press *Add Folder*, select the *examples* folder, and press *Next*.
+# On the *Java Sources Classpath* page, press *Add JAR/Folder* and select the openjpa-x.x.x/lib/geronimo-jpa_3.0_spec-1.0.jar which contains the JPA API classes which is used to compile against.
+# Press *Finish*
+# A new project will open, containing the OpenJPA jar and the examples source files.
+# On the *Package Explorer*, expand the top-level folder, then the *examples* folder, then *hellojpa*.
+# Navigate to the *build.xml* file in the *hellojpa* folder (note that there is also a *build.xml* file in the parent folder, which should not be used). Right-click the *build.xml* file, and select the *Run Target* sub-menu, then select *run*.
+# The database will be initialized (using the stand-alone Derby database, which is included with the OpenJPA distribution) and the *Main.java* class will be run. In the *Console*, you should see the text _Hello Persistence!_.
+# Congratulations! You have run your first sample program using OpenJPA. Examine the *Main.java* example program, as well as the *Message.java* entity class, play with them by adding fields and working on new persistence operations. Have fun!
\ No newline at end of file

Propchange: openjpa/site/trunk/content/getting-started.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/getting-started.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/getting-started.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/getting-started.mdtext (added)
+++ openjpa/site/trunk/content/getting-started.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,100 @@
+Title: Getting started
+<a name="Gettingstarted-Notes"></a>
+### Notes
+These instructions detail the steps required to run a give sample for a number of different environments. You can substitute any of the directories in the \[binary download\](binary-download\.html)
+\examples\ directory for *hellojpa* in the instructions below to run a
+different sample.
+
+<a name="Gettingstarted-GettingStartedwiththeEclipse"></a>
+### Getting Started with the Eclipse
+
+1. Download the OpenJPA binary release from the [downloads](downloads.html)
+ page and unpack it by double-clicking it.
+1. Launch Eclipse (this sample was tested with Eclipse 3.2.1, but any recent
+version should work).
+1. Select the *File* menu, traverse to the *New* sub-menu, and select
+*Project*.
+1. On the *Select a wizard* page, select *Java Project from Existing Ant
+Buildfile*, then click the *Next* button.
+1. Hit the *Browse* button next to the *Ant Buildfile* field, and navigate
+to the unpacked OpenJPA zip file on the desktop, then traverse through
+*examples*, then *hellojpa*, and select the *build.xml* file and hit the
+*Open* button.
+1. Hit the *Finish* button on the wizard.
+1. A new project will open, containing the OpenJPA jar and all its
+dependencies.
+1. On the *Package Explorer*, expand the top-level folder, then the
+*examples* folder, then *hellojpa*.
+1. Select the *build.xml* file in the *hellojpa* folder (note that there is
+also a *build.xml* file in the parent folder, which should not be
+selected). Right-click the *build.xml* file, and select the *Run As*
+sub-menu, then select *Ant Build*.
+1. The database will be initialized (using the stand-alone Derby database,
+which is included with the OpenJPA distribution) and the *Main.java* class
+will be run. In the *Console*, you should see the text _Hello
+Persistence!_.
+1. Congratulations! You have run your first sample program using OpenJPA.
+Examine the *Main.java* example program, as well as the *Message.java*
+entity class, play with them by adding fields and working on new
+persistence operations. Have fun!
+
+<a name="Gettingstarted-GettingStartedwiththeConsole"></a>
+### Getting Started with the Console
+
+1. Ensure that you have [Apache Ant](http://ant.apache.org/)
+ installed (this sample was tested with ant 1.6.5, but any recent version
+should work).
+1. Download the OpenJPA binary release from the [downloads](downloads.html)
+ page and unpack it by double-clicking it.
+1. Launch a console, such as *cmd.exe* on Windows, *Terminal.app* on Mac, or
+*xterm* on UNIX.
+1. Change directories to the Desktop, then cd to the unpacked OpenJPA
+folder.
+1. cd to the *examples* subdirectory, then to the *hellojpa* subdirectory.
+1. Run *ant*, which will compile the classes and run the sample application.
+At the end of the build, you should see the text _Hello Persistence!_.
+1. Congratulations! You have run your first sample program using OpenJPA.
+Examine the *Main.java* example program, as well as the *Message.java*
+entity class, play with them by adding fields and working on new
+persistence operations. Have fun!
+
+<a name="Gettingstarted-GettingStartedwithNetbeans"></a>
+### Getting Started with Netbeans
+
+1. Download the OpenJPA binary release from the [downloads](downloads.html)
+ page and unpack it by double-clicking it.
+1. Launch Netbeans (this sample was tested with Netbeans 5.5, but any recent
+version should work).
+1. Select the *File* menu and select *New Project*.
+1. On the *New Project* page, select Category:*General* Projects:*Java
+Project with Existing Ant Script*, then click the *Next* button.
+1. Press the *Browse* button next to the *Location* field, and navigate to
+the unpacked OpenJPA directory
+1. Press the *Browse* button next to the *Build Script* field, and navigate
+to the unpacked OpenJPA directory through *examples*, then *hellojpa*, and
+select the *build.xml* file and press the *Open* button.
+1. Type a name for the project, press *Set as Main Project* and press the
+*Next* button on the wizard.
+1. Press *Next* to accept the *Build and Run Actions*.
+1. On the *Source Package Folders* page, press *Add Folder*, select the
+*examples* folder, and press *Next*.
+1. On the *Java Sources Classpath* page, press *Add JAR/Folder* and select
+the openjpa-x.x.x/lib/geronimo-jpa_3.0_spec-1.0.jar which contains the JPA
+API classes which is used to compile against.
+1. Press *Finish*
+1. A new project will open, containing the OpenJPA jar and the examples
+source files.
+1. On the *Package Explorer*, expand the top-level folder, then the
+*examples* folder, then *hellojpa*.
+1. Navigate to the *build.xml* file in the *hellojpa* folder (note that
+there is also a *build.xml* file in the parent folder, which should not be
+used). Right-click the *build.xml* file, and select the *Run Target*
+sub-menu, then select *run*.
+1. The database will be initialized (using the stand-alone Derby database,
+which is included with the OpenJPA distribution) and the *Main.java* class
+will be run. In the *Console*, you should see the text _Hello
+Persistence!_.
+1. Congratulations! You have run your first sample program using OpenJPA.
+Examine the *Main.java* example program, as well as the *Message.java*
+entity class, play with them by adding fields and working on new
+persistence operations. Have fun!

Added: openjpa/site/trunk/content/images/asf_logo_wide2.png
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/images/asf_logo_wide2.png?rev=1409057&view=auto
==============================================================================
Binary file - no diff available.

Propchange: openjpa/site/trunk/content/images/asf_logo_wide2.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: openjpa/site/trunk/content/images/check.gif
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/images/check.gif?rev=1409057&view=auto
==============================================================================
Binary file - no diff available.

Propchange: openjpa/site/trunk/content/images/check.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: openjpa/site/trunk/content/images/header-bg3.png
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/images/header-bg3.png?rev=1409057&view=auto
==============================================================================
Binary file - no diff available.

Propchange: openjpa/site/trunk/content/images/header-bg3.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: openjpa/site/trunk/content/images/openjpa-logo.png
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/images/openjpa-logo.png?rev=1409057&view=auto
==============================================================================
Binary file - no diff available.

Propchange: openjpa/site/trunk/content/images/openjpa-logo.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: openjpa/site/trunk/content/index
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/index?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/index (added)
+++ openjpa/site/trunk/content/index Wed Nov 14 01:49:37 2012
@@ -0,0 +1,45 @@
+h2. Welcome to the Apache OpenJPA project
+\\
+{include:openjpa:Intro}
+
+\\ 
+
+{hide-from}
+{section}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Download.png!|link=http://openjpa.apache.org/downloads.html|title=Download Apache OpenJPA|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Clock.png!|link=http://openjpa.apache.org/quick-start.html|title=Quick Start Guide|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Information.png!|link=http://openjpa.apache.org/documentation.html|title=User's Guide|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{section}
+{hide-from}
+
+\\ 
+
+h2. [News|Events and News] 
+
+\\
+
+{blog-posts:max=5} 
+
+\\
+
+h2. Resources
+
+* [Quick Start Guide to OpenJPA|Quick Start]
+* [Obtaining OpenJPA|Obtaining]
+* [OpenJPA Documentation|Documentation]
+* [Integration with Containers and Application Servers|Integration]
+* [Enhancing entities with Maven2|Entity Enhancement]
+* OpenJPA can be browsed (and checked out using [SVN|http://subversion.tigris.org/] from): [http://svn.apache.org/repos/asf/openjpa/trunk/]
+* Bugs and other issues can be reported at: [http://issues.apache.org/jira/browse/OPENJPA]
+* Development questions can be addressed to: [mailto:dev@openjpa.apache.org] ([archives|http://mail-archives.apache.org/mod_mbox/openjpa-dev/])
+* [OpenJPA development resources|OpenJPA Development Resources]
+ 
+\\
+

Added: openjpa/site/trunk/content/index-top-link
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/index-top-link?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/index-top-link (added)
+++ openjpa/site/trunk/content/index-top-link Wed Nov 14 01:49:37 2012
@@ -0,0 +1 @@
+[Index]
\ No newline at end of file

Added: openjpa/site/trunk/content/index-top-link.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/index-top-link.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/index-top-link.cwiki (added)
+++ openjpa/site/trunk/content/index-top-link.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1 @@
+[Index]
\ No newline at end of file

Propchange: openjpa/site/trunk/content/index-top-link.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/index-top-link.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/index-top-link.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/index-top-link.mdtext (added)
+++ openjpa/site/trunk/content/index-top-link.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,2 @@
+Title: Index Top Link
+[Index](index.html)

Added: openjpa/site/trunk/content/index.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/index.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/index.cwiki (added)
+++ openjpa/site/trunk/content/index.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1,45 @@
+h2. Welcome to the Apache OpenJPA project
+\\
+{include:openjpa:Intro}
+
+\\ 
+
+{hide-from}
+{section}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Download.png!|link=http://openjpa.apache.org/downloads.html|title=Download Apache OpenJPA|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Clock.png!|link=http://openjpa.apache.org/quick-start.html|title=Quick Start Guide|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Information.png!|link=http://openjpa.apache.org/documentation.html|title=User's Guide|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{section}
+{hide-from}
+
+\\ 
+
+h2. [News|Events and News] 
+
+\\
+
+{blog-posts:max=5} 
+
+\\
+
+h2. Resources
+
+* [Quick Start Guide to OpenJPA|Quick Start]
+* [Obtaining OpenJPA|Obtaining]
+* [OpenJPA Documentation|Documentation]
+* [Integration with Containers and Application Servers|Integration]
+* [Enhancing entities with Maven2|Entity Enhancement]
+* OpenJPA can be browsed (and checked out using [SVN|http://subversion.tigris.org/] from): [http://svn.apache.org/repos/asf/openjpa/trunk/]
+* Bugs and other issues can be reported at: [http://issues.apache.org/jira/browse/OPENJPA]
+* Development questions can be addressed to: [mailto:dev@openjpa.apache.org] ([archives|http://mail-archives.apache.org/mod_mbox/openjpa-dev/])
+* [OpenJPA development resources|OpenJPA Development Resources]
+ 
+\\
+

Propchange: openjpa/site/trunk/content/index.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/index.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/index.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/index.mdtext (added)
+++ openjpa/site/trunk/content/index.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,60 @@
+Title: Index
+<a name="Index-WelcometotheApacheOpenJPAproject"></a>
+## Welcome to the Apache OpenJPA project
+  
+  
+{include:openjpa:Intro}
+
+  
+  
+
+{hide-from}
+{section}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Download.png!|link=http://openjpa.apache.org/downloads.html|title=Download
+Apache OpenJPA|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Clock.png!|link=http://openjpa.apache.org/quick-start.html|title=Quick
+Start Guide|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{column:width=20%}{lozenge:icon=!http://openjpa.apache.org/images/fotolia/Fotolia_9174675_Information.png!|link=http://openjpa.apache.org/documentation.html|title=User's
+Guide|arrow=none|width=100%}
+{lozenge}{column}
+{column:width=10%}{column}
+{section}
+{hide-from}
+
+  
+  
+
+<a name="Index-[News](eventsandnews.html)"></a>
+## [News|Events and News]
+
+  
+  
+
+{blog-posts:max=5} 
+
+  
+  
+
+<a name="Index-Resources"></a>
+## Resources
+
+* [Quick Start Guide to OpenJPA](quick-start.html)
+* [Obtaining OpenJPA](obtaining.html)
+* [OpenJPA Documentation](documentation.html)
+* [Integration with Containers and Application Servers](integration.html)
+* [Enhancing entities with Maven2](entity-enhancement.html)
+* OpenJPA can be browsed (and checked out using [SVN](http://subversion.tigris.org/)
+ from): [http://svn.apache.org/repos/asf/openjpa/trunk/]
+* Bugs and other issues can be reported at: [http://issues.apache.org/jira/browse/OPENJPA](http://issues.apache.org/jira/browse/OPENJPA)
+* Development questions can be addressed to: [mailto:dev@openjpa.apache.org](mailto:dev@openjpa.apache.org.html)
+ ([archives|http://mail-archives.apache.org/mod_mbox/openjpa-dev/])
+* [OpenJPA development resources](openjpa-development-resources.html)
+ 
+  
+  
+

Added: openjpa/site/trunk/content/integration
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/integration?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/integration (added)
+++ openjpa/site/trunk/content/integration Wed Nov 14 01:49:37 2012
@@ -0,0 +1,51 @@
+{excerpt:hidden=true}How to integrate OpenJPA with various containers and application servers{excerpt}
+
+h2. Runtime Dependencies
+
+The binary release download of OpenJPA includes all of the code needed to run in a stand-alone Java SE JVM or within a Java EE application server.
+See [Build and Runtime Dependencies] for details on the required Java levels and runtime artifacts.
+
+
+h2. Integrating with Apache Geronimo:
+
+[Apache Geronimo|http://geronimo.apache.org/] V2.0.2 through 2.1.3 include OpenJPA 1.0.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.
+Apache Geronimo V2.1.4 includes OpenJPA 1.2.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.
+
+h2. Integrating with GlassFish:
+
+Since [GlassFish|http://glassfish.dev.java.net] implements the Java Persistence API 1.0 SPI, it is very easy to use OpenJPA in Glassfish. See [Sahoo's blog |http://weblogs.java.net/blog/ss141213/archive/2006/07/using_openjpa_a.html] for further details.
+
+h2. Integrating with Sun Java System Application Server 9.x:
+
+Since Sun Java System Application Server is based on code from the [GlassFish project|http://glassfish.dev.java.net], the instructions to use OpenJPA in GlassFish and Sun Java System Application Server remain the same. 
+
+h2. Integrating with IBM WebSphere Application Server:
+
+See [IBM WebSphere Developer Technical Journal: Leveraging OpenJPA with WebSphere Application Server V6.1|http://www-128.ibm.com/developerworks/websphere/techjournal/0612_barcia/0612_barcia.html].
+Also, WebSphere Application Server V6.1 can download and install the [EJB3 Feature Pack|http://www-01.ibm.com/support/docview.wss?rs=177&uid=swg21287579], which includes OpenJPA 1.0.x.
+[WebSphere Application Server V7.0|http://www.ibm.com/developerworks/downloads/ws/was/] includes OpenJPA 1.2.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.  
+The [WebSphere Application Server V7 Feature Pack for OSGi Applications and Java Persistence API 2.0|http://www-01.ibm.com/software/webservers/appserv/was/featurepacks/osgi/] includes OpenJPA 2.0 and provides the use of the JPA 2.0 programming model within Java EE5 and OSGi applications.
+
+h2. Integrating with IBM WebSphere Application Server Community Edition:
+
+[WebSphere Application Server Community Edition|http://www.ibm.com/developerworks/websphere/zones/was/wasce.html] V2.0.0.2 through 2.1.1.1 include OpenJPA 1.0.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.
+WebSphere Application Server Community Edition V2.1.x releases after V2.1.1.1 will include OpenJPA 1.2.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.
+
+
+h2. Integrating with JOnAS Application Server V 4.X (J2EE 1.4 / EJB2.1 Container):
+
+OpenJPA can successfully be integrated with the JOnAS 4.x Application server family. I succeeded in configuring OpenJPA to use managed JTA transactions of JOnAS, which means that you can use OpenJPA in parallel to EJB 2.1 CMP/BMP  Entity Beans within the SAME container managed transactions of your JOnAS Application Server. See [Hans Prueller's blog entry|http://hanzz.zapto.org/index.php?option=com_content&task=view&id=105&Itemid=31] for further details.
+
+h2. Integrating with BEA Weblogic Server 10:
+
+[BEA WebLogic Server 10|http://www.bea.com/framework.jsp?CNT=index.htm&FP=/content/products/weblogic/] includes OpenJPA. To use OpenJPA in a WebLogic Server environment, you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit. The default persistence provider in WebLogic Server is OpenJPA + Kodo, so you can either leave the <provider> element out of your persistence.xml file, or set it to org.apache.openjpa.persistence.PersistenceProviderImpl.
+
+[BEA Kodo|http://www.bea.com/framework.jsp?CNT=index.htm&FP=/content/products/weblogic/kodo/] is built on top of OpenJPA, and so includes the OpenJPA jars.
+
+h2. Integrating with Spring:
+
+It is not necessary to configure a Spring loadTimeWeaver when using OpenJPA build time enhancement. The following warning message will be logged by OpenJPA when creating an EntityManagerFactory but it can be safely ignored.
+
+bq. WARN   \[main\] openjpa.Runtime - An error occurred while registering a ClassTransformer with PersistenceUnitInfo: name 'PuName', root URL \[file:/.../\]. The error has been consumed. To see it, set your openjpa.Runtime log level to TRACE. Load-time class transformation will not be available.
+
+Please see the [Spring documentation|http://static.springframework.org/spring/docs/2.0.x/reference/orm.html#orm-jpa-setup-lcemfb] for more information.
\ No newline at end of file

Added: openjpa/site/trunk/content/integration.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/integration.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/integration.cwiki (added)
+++ openjpa/site/trunk/content/integration.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1,59 @@
+{excerpt:hidden=true}How to integrate OpenJPA with various containers and application servers{excerpt}
+
+h2. Runtime Dependencies
+
+The binary release download of OpenJPA includes all of the code needed to run in a stand-alone Java SE JVM or within a Java EE application server.
+See [Build and Runtime Dependencies] for details on the required Java levels and runtime artifacts.
+
+
+h2. Integrating with Apache TomEE:
+
+[Apache TomEE|http://tomee.apache.org/] is a distribution of Tomcat bundled with OpenJPA and the other necessary components to make it a Java EE 6 compliant Web Profile implementation.  Apache TomEE 1.0.0 and later include OpenJPA 2.2.x.  TomEE works in [Eclipse using the Tomcat adapter|http://www.youtube.com/watch?v=Lr8pxEACVRI] and you can simply deploy a web archive that contains a persistence unit without the need to include OpenJPA in the webapp.  Unlike putting OpenJPA in Tomcat, TomEE supports full container managed EntityManagers and JTA persistence units.
+
+h2. Integrating with Apache TomEE:
+
+[Apache TomEE|http://tomee.apache.org/] is a distribution of Tomcat bundled with OpenJPA and the other necessary components to make it a Java EE 6 compliant Web Profile implementation.  Apache TomEE 1.0.0 and later include OpenJPA 2.2.x.  TomEE works in [Eclipse using the Tomcat adapter|http://www.youtube.com/watch?v=Lr8pxEACVRI] and you can simply deploy a web archive that contains a persistence unit without the need to include OpenJPA in the webapp.  Unlike putting OpenJPA in Tomcat, TomEE supports full container managed EntityManagers and JTA persistence units.
+
+h2. Integrating with Apache Geronimo:
+
+[Apache Geronimo|http://geronimo.apache.org/] V2.0.2 through 2.1.3 include OpenJPA 1.0.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.
+Apache Geronimo V2.1.4 includes OpenJPA 1.2.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.
+
+h2. Integrating with GlassFish:
+
+Since [GlassFish|http://glassfish.dev.java.net] implements the Java Persistence API 1.0 SPI, it is very easy to use OpenJPA in Glassfish. See [Sahoo's blog |http://weblogs.java.net/blog/ss141213/archive/2006/07/using_openjpa_a.html] for further details.
+
+h2. Integrating with Sun Java System Application Server 9.x:
+
+Since Sun Java System Application Server is based on code from the [GlassFish project|http://glassfish.dev.java.net], the instructions to use OpenJPA in GlassFish and Sun Java System Application Server remain the same. 
+
+h2. Integrating with IBM WebSphere Application Server:
+
+See [IBM WebSphere Developer Technical Journal: Leveraging OpenJPA with WebSphere Application Server V6.1|http://www-128.ibm.com/developerworks/websphere/techjournal/0612_barcia/0612_barcia.html].
+Also, WebSphere Application Server V6.1 can download and install the [EJB3 Feature Pack|http://www-01.ibm.com/support/docview.wss?rs=177&uid=swg21287579], which includes OpenJPA 1.0.x.
+[WebSphere Application Server V7.0|http://www.ibm.com/developerworks/downloads/ws/was/] includes OpenJPA 1.2.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.  
+The [WebSphere Application Server V7 Feature Pack for OSGi Applications and Java Persistence API 2.0|http://www-01.ibm.com/software/webservers/appserv/was/featurepacks/osgi/] includes OpenJPA 2.0 and provides the use of the JPA 2.0 programming model within Java EE5 and OSGi applications.
+
+h2. Integrating with IBM WebSphere Application Server Community Edition:
+
+[WebSphere Application Server Community Edition|http://www.ibm.com/developerworks/websphere/zones/was/wasce.html] V2.0.0.2 through 2.1.1.1 include OpenJPA 1.0.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.
+WebSphere Application Server Community Edition V2.1.x releases after V2.1.1.1 will include OpenJPA 1.2.x and you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit.
+
+
+h2. Integrating with JOnAS Application Server V 4.X (J2EE 1.4 / EJB2.1 Container):
+
+OpenJPA can successfully be integrated with the JOnAS 4.x Application server family. I succeeded in configuring OpenJPA to use managed JTA transactions of JOnAS, which means that you can use OpenJPA in parallel to EJB 2.1 CMP/BMP  Entity Beans within the SAME container managed transactions of your JOnAS Application Server. See [Hans Prueller's blog entry|http://hanzz.zapto.org/index.php?option=com_content&task=view&id=105&Itemid=31] for further details.
+
+h2. Integrating with BEA Weblogic Server 10:
+
+[BEA WebLogic Server 10|http://www.bea.com/framework.jsp?CNT=index.htm&FP=/content/products/weblogic/] includes OpenJPA. To use OpenJPA in a WebLogic Server environment, you can simply deploy an enterprise archive, web archive, or EJB-JAR that contains a persistence unit. The default persistence provider in WebLogic Server is OpenJPA + Kodo, so you can either leave the <provider> element out of your persistence.xml file, or set it to org.apache.openjpa.persistence.PersistenceProviderImpl.
+
+[BEA Kodo|http://www.bea.com/framework.jsp?CNT=index.htm&FP=/content/products/weblogic/kodo/] is built on top of OpenJPA, and so includes the OpenJPA jars.
+
+h2. Integrating with Spring:
+
+It is not necessary to configure a Spring loadTimeWeaver when using OpenJPA build time enhancement. The following warning message will be logged by OpenJPA when creating an EntityManagerFactory but it can be safely ignored.
+
+bq. WARN   \[main\] openjpa.Runtime - An error occurred while registering a ClassTransformer with PersistenceUnitInfo: name 'PuName', root URL \[file:/.../\]. The error has been consumed. To see it, set your openjpa.Runtime log level to TRACE. Load-time class transformation will not be available.
+
+Please see the [Spring documentation|http://static.springframework.org/spring/docs/2.0.x/reference/orm.html#orm-jpa-setup-lcemfb] for more information.

Propchange: openjpa/site/trunk/content/integration.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/integration.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/integration.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/integration.mdtext (added)
+++ openjpa/site/trunk/content/integration.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,104 @@
+Title: Integration
+{excerpt:hidden=true}How to integrate OpenJPA with various containers and
+application servers{excerpt}
+
+<a name="Integration-RuntimeDependencies"></a>
+## Runtime Dependencies
+
+The binary release download of OpenJPA includes all of the code needed to
+run in a stand-alone Java SE JVM or within a Java EE application server.
+See [Build and Runtime Dependencies](build-and-runtime-dependencies.html)
+ for details on the required Java levels and runtime artifacts.
+
+
+<a name="Integration-IntegratingwithApacheGeronimo:"></a>
+## Integrating with Apache Geronimo:
+
+[Apache Geronimo](http://geronimo.apache.org/)
+ V2.0.2 through 2.1.3 include OpenJPA 1.0.x and you can simply deploy an
+enterprise archive, web archive, or EJB-JAR that contains a persistence
+unit.
+Apache Geronimo V2.1.4 includes OpenJPA 1.2.x and you can simply deploy an
+enterprise archive, web archive, or EJB-JAR that contains a persistence
+unit.
+
+<a name="Integration-IntegratingwithGlassFish:"></a>
+## Integrating with GlassFish:
+
+Since [GlassFish](http://glassfish.dev.java.net)
+ implements the Java Persistence API 1.0 SPI, it is very easy to use
+OpenJPA in Glassfish. See [Sahoo's blog |http://weblogs.java.net/blog/ss141213/archive/2006/07/using_openjpa_a.html]
+ for further details.
+
+<a name="Integration-IntegratingwithSunJavaSystemApplicationServer9.x:"></a>
+## Integrating with Sun Java System Application Server 9.x:
+
+Since Sun Java System Application Server is based on code from the [GlassFish project](http://glassfish.dev.java.net)
+, the instructions to use OpenJPA in GlassFish and Sun Java System
+Application Server remain the same. 
+
+<a name="Integration-IntegratingwithIBMWebSphereApplicationServer:"></a>
+## Integrating with IBM WebSphere Application Server:
+
+See [IBM WebSphere Developer Technical Journal: Leveraging OpenJPA with WebSphere Application Server V6.1](http://www-128.ibm.com/developerworks/websphere/techjournal/0612_barcia/0612_barcia.html)
+.
+Also, WebSphere Application Server V6.1 can download and install the [EJB3 Feature Pack](http://www-01.ibm.com/support/docview.wss?rs=177&uid=swg21287579)
+, which includes OpenJPA 1.0.x.
+[WebSphere Application Server V7.0](http://www.ibm.com/developerworks/downloads/ws/was/)
+ includes OpenJPA 1.2.x and you can simply deploy an enterprise archive,
+web archive, or EJB-JAR that contains a persistence unit.  
+The [WebSphere Application Server V7 Feature Pack for OSGi Applications and Java Persistence API 2.0](http://www-01.ibm.com/software/webservers/appserv/was/featurepacks/osgi/)
+ includes OpenJPA 2.0 and provides the use of the JPA 2.0 programming model
+within Java EE5 and OSGi applications.
+
+<a name="Integration-IntegratingwithIBMWebSphereApplicationServerCommunityEdition:"></a>
+## Integrating with IBM WebSphere Application Server Community Edition:
+
+[WebSphere Application Server Community Edition](http://www.ibm.com/developerworks/websphere/zones/was/wasce.html)
+ V2.0.0.2 through 2.1.1.1 include OpenJPA 1.0.x and you can simply deploy
+an enterprise archive, web archive, or EJB-JAR that contains a persistence
+unit.
+WebSphere Application Server Community Edition V2.1.x releases after
+V2.1.1.1 will include OpenJPA 1.2.x and you can simply deploy an enterprise
+archive, web archive, or EJB-JAR that contains a persistence unit.
+
+
+h2. Integrating with JOnAS Application Server V 4.X (J2EE 1.4 / EJB2.1
+Container):
+
+OpenJPA can successfully be integrated with the JOnAS 4.x Application
+server family. I succeeded in configuring OpenJPA to use managed JTA
+transactions of JOnAS, which means that you can use OpenJPA in parallel to
+EJB 2.1 CMP/BMP  Entity Beans within the SAME container managed
+transactions of your JOnAS Application Server. See [Hans Prueller's blog entry](http://hanzz.zapto.org/index.php?option=com_content&task=view&id=105&Itemid=31)
+ for further details.
+
+<a name="Integration-IntegratingwithBEAWeblogicServer10:"></a>
+## Integrating with BEA Weblogic Server 10:
+
+[BEA WebLogic Server 10](http://www.bea.com/framework.jsp?CNT=index.htm&FP=/content/products/weblogic/)
+ includes OpenJPA. To use OpenJPA in a WebLogic Server environment, you can
+simply deploy an enterprise archive, web archive, or EJB-JAR that contains
+a persistence unit. The default persistence provider in WebLogic Server is
+OpenJPA + Kodo, so you can either leave the <provider> element out of your
+persistence.xml file, or set it to
+org.apache.openjpa.persistence.PersistenceProviderImpl.
+
+[BEA Kodo](http://www.bea.com/framework.jsp?CNT=index.htm&FP=/content/products/weblogic/kodo/)
+ is built on top of OpenJPA, and so includes the OpenJPA jars.
+
+<a name="Integration-IntegratingwithSpring:"></a>
+## Integrating with Spring:
+
+It is not necessary to configure a Spring loadTimeWeaver when using OpenJPA
+build time enhancement. The following warning message will be logged by
+OpenJPA when creating an EntityManagerFactory but it can be safely ignored.
+
+bq. WARN   \[main\](main\.html)
+ openjpa.Runtime - An error occurred while registering a ClassTransformer
+with PersistenceUnitInfo: name 'PuName', root URL \[file:/.../\]. The error
+has been consumed. To see it, set your openjpa.Runtime log level to TRACE.
+Load-time class transformation will not be available.
+
+Please see the [Spring documentation](http://static.springframework.org/spring/docs/2.0.x/reference/orm.html#orm-jpa-setup-lcemfb)
+ for more information.

Added: openjpa/site/trunk/content/intro
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/intro?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/intro (added)
+++ openjpa/site/trunk/content/intro Wed Nov 14 01:49:37 2012
@@ -0,0 +1,7 @@
+Apache OpenJPA is a Java persistence project at [The Apache Software Foundation|http://apache.org] that can be used as a stand-alone [POJO|http://en.wikipedia.org/wiki/POJO] persistence layer or [integrated|Integration] into any Java EE compliant container and many other lightweight frameworks, such as Tomcat and Spring. 
+
+The [1.x releases|openjpa:Downloads] (1.2.2 is the latest) are a production ready, feature-rich, compliant implementation of the Java Persistence API (JPA) 1.0 part of the [JSR-220 Enterprise Java Beans 3.0|http://jcp.org/en/jsr/detail?id=220] specification, which pass the Sun JPA 1.0b Technology Compatibility Kit.
+
+The [2.x releases|openjpa:Downloads] (2.2.0 is the latest) are a production ready, compliant implementation of the [JSR-317 Java Persistence 2.0|http://jcp.org/en/jsr/detail?id=317] specification, which is backwards compatible to the JPA 1.0 specification and passes the Sun JPA 2.0 Technology Compatibility Kit.
+
+The upcoming 2.3 release is based off of the 2.2.x release stream and will contain some additional features (TBD). 
\ No newline at end of file

Added: openjpa/site/trunk/content/intro.cwiki
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/intro.cwiki?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/intro.cwiki (added)
+++ openjpa/site/trunk/content/intro.cwiki Wed Nov 14 01:49:37 2012
@@ -0,0 +1,7 @@
+Apache OpenJPA is a Java persistence project at [The Apache Software Foundation|http://apache.org] that can be used as a stand-alone [POJO|http://en.wikipedia.org/wiki/POJO] persistence layer or [integrated|Integration] into any Java EE compliant container and many other lightweight frameworks, such as Tomcat and Spring. 
+
+The [1.x releases|openjpa:Downloads] (1.2.2 is the latest) are a production ready, feature-rich, compliant implementation of the Java Persistence API (JPA) 1.0 part of the [JSR-220 Enterprise Java Beans 3.0|http://jcp.org/en/jsr/detail?id=220] specification, which pass the Sun JPA 1.0b Technology Compatibility Kit.
+
+The [2.x releases|openjpa:Downloads] (2.2.0 is the latest) are a production ready, compliant implementation of the [JSR-317 Java Persistence 2.0|http://jcp.org/en/jsr/detail?id=317] specification, which is backwards compatible to the JPA 1.0 specification and passes the Sun JPA 2.0 Technology Compatibility Kit.
+
+The upcoming 2.3 release is based off of the 2.2.x release stream and will contain some additional features (TBD). 
\ No newline at end of file

Propchange: openjpa/site/trunk/content/intro.cwiki
------------------------------------------------------------------------------
    svn:eol-style = native

Added: openjpa/site/trunk/content/intro.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/intro.mdtext?rev=1409057&view=auto
==============================================================================
--- openjpa/site/trunk/content/intro.mdtext (added)
+++ openjpa/site/trunk/content/intro.mdtext Wed Nov 14 01:49:37 2012
@@ -0,0 +1,20 @@
+Title: Intro
+Apache OpenJPA is a Java persistence project at [The Apache Software Foundation](http://apache.org)
+ that can be used as a stand-alone [POJO|http://en.wikipedia.org/wiki/POJO]
+ persistence layer or [integrated|Integration]
+ into any Java EE compliant container and many other lightweight
+frameworks, such as Tomcat and Spring. 
+
+The [1.x releases](openjpa:downloads.html)
+ (1.2.2 is the latest) are a production ready, feature-rich, compliant
+implementation of the Java Persistence API (JPA) 1.0 part of the [JSR-220 Enterprise Java Beans 3.0|http://jcp.org/en/jsr/detail?id=220]
+ specification, which pass the Sun JPA 1.0b Technology Compatibility Kit.
+
+The [2.x releases](openjpa:downloads.html)
+ (2.2.0 is the latest) are a production ready, compliant implementation of
+the [JSR-317 Java Persistence 2.0|http://jcp.org/en/jsr/detail?id=317]
+ specification, which is backwards compatible to the JPA 1.0 specification
+and passes the Sun JPA 2.0 Technology Compatibility Kit.
+
+The upcoming 2.3 release is based off of the 2.2.x release stream and will
+contain some additional features (TBD). 



Mime
View raw message