You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openjpa.apache.org by cu...@apache.org on 2012/11/21 17:13:21 UTC
svn commit: r1412169 - in /openjpa/site/trunk: WhoIsWorkingOnWhat.txt
content/update-release-text-files.mdtext
content/using-criteria-api-in-daytrader.mdtext
Author: curtisr7
Date: Wed Nov 21 16:13:21 2012
New Revision: 1412169
URL: http://svn.apache.org/viewvc?rev=1412169&view=rev
Log:
wiki updates.
Modified:
openjpa/site/trunk/WhoIsWorkingOnWhat.txt
openjpa/site/trunk/content/update-release-text-files.mdtext
openjpa/site/trunk/content/using-criteria-api-in-daytrader.mdtext
Modified: openjpa/site/trunk/WhoIsWorkingOnWhat.txt
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/WhoIsWorkingOnWhat.txt?rev=1412169&r1=1412168&r2=1412169&view=diff
==============================================================================
--- openjpa/site/trunk/WhoIsWorkingOnWhat.txt (original)
+++ openjpa/site/trunk/WhoIsWorkingOnWhat.txt Wed Nov 21 16:13:21 2012
@@ -122,8 +122,8 @@ done source-code.mdtext
thanks.mdtext
done tools.mdtext
top-navigation-bar.mdtext
- update-release-text-files.mdtext
- using-criteria-api-in-daytrader.mdtext
+done update-release-text-files.mdtext
+done using-criteria-api-in-daytrader.mdtext
done verifying-release-signatures.mdtext
done websphere-application-server.mdtext
delete? whither-openjpa.mdtext
Modified: openjpa/site/trunk/content/update-release-text-files.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/update-release-text-files.mdtext?rev=1412169&r1=1412168&r2=1412169&view=diff
==============================================================================
--- openjpa/site/trunk/content/update-release-text-files.mdtext (original)
+++ openjpa/site/trunk/content/update-release-text-files.mdtext Wed Nov 21 16:13:21 2012
@@ -1,11 +1,8 @@
Title: Update release text files
-{excerpt:hidden=true}Instructions for updating .text files shipped with
-OpenJPA{excerpt}
<a name="Updatereleasetextfiles-Updatingreleasetextfiles."></a>
# Updating release text files.
-
<a name="Updatereleasetextfiles-ObtainingthelistofresolvedissuesfromJIRA. "></a>
## Obtaining the list of resolved issues from JIRA.
@@ -19,40 +16,31 @@ the documents you will edit.
## Update text files
* openjpa-projects/CHANGES.txt
-1. # Update the overview paragraph with the new version and a brief
-description of the release.
-1. # Remove the previous changes section and replace with a url to the
-location in SVN. _This is similar to what HTTPD does in its CHANGES file_
-1. # Create a new section : OpenJPA x.y.z changes and copy the JIRA issues
-resolved in this section. You may want to do some minor editing by hand to
-ensure the file respects the 80 character column width guideline.
+ * Update the overview paragraph with the new version and a brief description of the release.
+ * Remove the previous changes section and replace with a url to the location in SVN. _This is similar to what HTTPD does in its CHANGES file_
+ * Create a new section : OpenJPA x.y.z changes and copy the JIRA issues resolved in this section. You may want to do some minor editing by hand to ensure the file respects the 80 character column width guideline.
* openjpa-project/RELEASE-NOTES.html
-1. # Similar to CHANGES.txt you need to update the version number and provide
-a brief description of the release.
-1. # Remove the previous list of changes for the previous release. Replace
-this with a link to the last release's file in SVN.
-1. # Add a new section. This can be copied from the JIRA page with one
-exception (see the next step).
-1. # Update the links at the top of the file. If you've copied changes from
-JIRA you'll see a section like this :
-
- <h2> Bug
- </h2>
+ * Similar to CHANGES.txt you need to update the version number and provide a brief description of the release.
+ * Remove the previous list of changes for the previous release. Replace this with a link to the last release's file in SVN.
+ * Add a new section. This can be copied from the JIRA page with one exception (see the next step).
+ * Update the links at the top of the file. If you've copied changes from JIRA you'll see a section like this :
+
+ <h2> Bug </h2>
+
+ Replace it with :
-Replace it with
+ <h4><a name='Bug'>Bug</h4>
- <h4><a name='Bug'>Bug</h4>
+ You should also check the links at the top to make sure they are all valid.
-You should also check the links at the top to make sure they are all valid.
* openjpa-project/NOTICE.txt
-NOTICE.txt "usually" does not need to be updated. The exceptions are when a
-new dependency has been introduced (ie a new version of Serp) or if a new
-source file containing a copyright notice is introduced.
+NOTICE.txt "usually" does not need to be updated. The exceptions are when a new dependency has been introduced (ie a new version of Serp) or if a new source file containing a copyright notice is introduced.
+
* openjpa-project/LICENSE.txt
-Similar to NOTICE.txt this file does not require updating in each release.
-It should contain the current version of the Apache license, and any other
-licenses mentioned in NOTICE.txt.
+Similar to NOTICE.txt this file does not require updating in each release. It should contain the current version of the Apache license, and any other licenses mentioned in NOTICE.txt.
+
* openjpa-project/README.txt
This file rarely needs updating - just make sure the URL is accurate.
+
* openjpa-project/BUILDING.txt
This file rarely needs updating.
Modified: openjpa/site/trunk/content/using-criteria-api-in-daytrader.mdtext
URL: http://svn.apache.org/viewvc/openjpa/site/trunk/content/using-criteria-api-in-daytrader.mdtext?rev=1412169&r1=1412168&r2=1412169&view=diff
==============================================================================
--- openjpa/site/trunk/content/using-criteria-api-in-daytrader.mdtext (original)
+++ openjpa/site/trunk/content/using-criteria-api-in-daytrader.mdtext Wed Nov 21 16:13:21 2012
@@ -13,37 +13,27 @@ built-in Derby database.
## Downloading DayTrader
You must have Subversion installed in order to download the DayTrader implementation.Subversion can be downloaded from [http://subversion.apache.org/packages.html](http://subversion.apache.org/packages.html)
-. Use the 2.1.3 version of DayTrader for this sample. Follow the following
-steps:
-1. Create a root directory for the download. For this example, we will use a
-directory called *DayTrader*.
-1. Create subdirectories *branches/2.1.3* under the *DayTrader* directory
-1. cd to *DayTrader*
-1. Issue the following subversion command:
- svn checkout [https://svn.apache.org/repos/asf/geronimo/daytrader/branches/2.1.3](https://svn.apache.org/repos/asf/geronimo/daytrader/branches/2.1.3)
- branches/2.1.3
+. Use the 2.1.3 version of DayTrader for this sample. Follow the following steps:
+
+1. Create a root directory for the download. For this example, we will use a directory called *DayTrader*.
+2. Create subdirectories **branches/2.1.3** under the **DayTrader** directory
+3. cd to **DayTrader**
+4. Issue the following subversion command:
+
+ svn checkout https://svn.apache.org/repos/asf/geronimo/daytrader/branches/2.1.3 branches/2.1.3 .
<a name="UsingCriteriaAPIinDayTrader-BuildDayTrader"></a>
## Build DayTrader
-You must have maven installed in order to build DayTrader. Maven can be
-downloaded from [http://maven.apache.org/download.html](http://maven.apache.org/download.html)
-. Unzip the file to a directory and run mvn.bat\|.sh in the bin
+You must have maven installed in order to build DayTrader. Maven can be downloaded from <http://maven.apache.org/download.html>. Unzip the file to a directory and run mvn.bat\|.sh in the bin
subdirectory to install. Add the bin subdirectory to you system path.
Maven needs a repository. Typically it is at the following:
-* Windows - C:\Documents and Settings\<userid>\.m2\repository
-* Linux/unix - \~/.m2/repository
-
-From the *DayTrader/branches/2.1.3* directory, type "mvn clean install" to
-build the project. (Note: If you see errors that say
-"java.util.zip.ZipException: error in opening zip file", ignore them for
-this exercise.)
+* **Windows** - C:\Documents and Settings\<userid>\.m2\repository
+* **Linux/unix** - \~/.m2/repository
-
-<a name="UsingCriteriaAPIinDayTrader-"></a>
-##
+From the **DayTrader/branches/2.1.3** directory, type "mvn clean install" to build the project. (Note: If you see errors that say "java.util.zip.ZipException: error in opening zip file", ignore them for this exercise.)
<a name="UsingCriteriaAPIinDayTrader-ApplytheDayTraderPatch"></a>
## Apply the DayTrader Patch
@@ -51,30 +41,17 @@ this exercise.)
The following patch can be applied using a system or downloaded *patch* utility. (For example, you can get a patch utility for Windows from [http://gnuwin32.sourceforge.net/packages/patch.htm](http://gnuwin32.sourceforge.net/packages/patch.htm)
.)
-for Geronimo - [^daytrader_geronimo.patch](^daytrader_geronimo.patch.html)
-
-
-
-
-
-
-
-
-
-for WebSphere - [^daytrader_websphere.patch](^daytrader_websphere.patch.html)
-
-
+* Geronimo - [daytrader_geronimo.patch](artifacts/daytrader_geronimo.patch)
+* WebSphere - [daytrader_websphere.patch](artifacts/daytrader_websphere.patch)
Download the appropriate patch and go to the *DayTrader/branches.2.1.3*
directory to apply it. For example, with the patch utility mentioned above,
you can type:
-patch \-p0 \-i <path-to>/daytrader_geronimo.patch
+ patch \-p0 \-i <path-to>/daytrader_geronimo.patch
+
+After you have applied the patch, you can see the changes from JPQL to the Criteria API in the java class org.apache.geronimo.samples.daytrader.ejb3.TradeSLSBBean. The changes are in the following 4 methods:
-After you have applied the patch, you can see the changes from JPQL to the
-Criteria API in the java class
-org.apache.geronimo.samples.daytrader.ejb3.TradeSLSBBean. The changes are
-in the following 4 methods:
* getMarketSummary()
* getClosedOrders()
* getAllQuotes()
@@ -86,70 +63,47 @@ command again in order for this file to
You can also [Apply an Eclipse Patch](apply-an-eclipse-patch.html)
-
-
-
-
-
<a name="UsingCriteriaAPIinDayTrader-Re-createtheDayTraderearfile"></a>
## Re-create the DayTrader ear file
-From the *DayTrader/branches/2.1.3* directory, type "mvn clean install" to
-build the project.
-
-
-
+From the **DayTrader/branches/2.1.3** directory, type "mvn clean install" to build the project.
+
<a name="UsingCriteriaAPIinDayTrader-RunDayTraderonGeronimo"></a>
## Run DayTrader on Geronimo
This writeup assumes some familiarity with Apache Geronimo. The download
and documentation can be found at [http://geronimo.apache.org.](http://geronimo.apache.org/)
+Install and start the Geronimo server.
+Add jpa2 plugins from repository [http://geronimo.apache.org/plugins/openjpa2](http://geronimo.apache.org/plugins/openjpa2). One way to do this is the following:
-
-
-
-
-
-
-
-Install and start the Geronimo server
-
-Add jpa2 plugins from repository [http://geronimo.apache.org/plugins/openjpa2](http://geronimo.apache.org/plugins/openjpa2)
-. One way to do this is the following:
1. Go to the Geronimo console at http://<host>:8080/console and logon
-1. Select _plugins_
-1. Click on _Add Repository_ and add [http://geronimo.apache.org/plugins/openjpa2](http://geronimo.apache.org/plugins/openjpa2)
-1. Click on _Update Repository List_
-1. Make sure the new repository is selected. Then click on _Show Plugins in
-selected repository._ On that panel:
-1. # Select _GeronimoPlugins, OpenJPA2::CAR 2.1.3-SNAPSHOT_ and
-_GeronimoPlugins, OpenJPA2::Deployer 2.1.3-SNAPSHOT_
-1. # Click on _Install_
-1. On the next screen, click on _Install_
+2. Select _plugins_
+3. Click on _Add Repository_ and add [http://geronimo.apache.org/plugins/openjpa2](http://geronimo.apache.org/plugins/openjpa2)
+4. Click on _Update Repository List_
+5. Make sure the new repository is selected. Then click on _Show Plugins in selected repository._ On that panel:
+ 1. Select _GeronimoPlugins, OpenJPA2::CAR 2.1.3-SNAPSHOT_ and _GeronimoPlugins, OpenJPA2::Deployer 2.1.3-SNAPSHOT_
+ 2. Click on _Install_
+6. On the next screen, click on _Install_
+
+Deploy the DayTrader application. This can be done through the console as follows:
-Deploy the DayTrader application. This can be done through the console as
-follows:
1. Click on _Deploy New_
-1. For _Archive_, browse to
-DayTrader/branches/2.1.3/modules/ear/target/daytrader-ear-2.1.3.ear
-1. For _Plan,_ browse to
-DayTrader/branches/2.1.3/plans/dayTrader-derby-plan.xml
-1. Check _Start app after install_
-1. Click on _Install_
+2. For _Archive_, browse to DayTrader/branches/2.1.3/modules/ear/target/daytrader-ear-2.1.3.ear
+3. For _Plan,_ browse to DayTrader/branches/2.1.3/plans/dayTrader-derby-plan.xml
+4. Check _Start app after install_
+5. Click on _Install_
Re-start the server.
-Make sure that the system module,
-org.apache.geronimo.configs/axis-deployer/2.1.5/car, is running.
+Make sure that the system module, org.apache.geronimo.configs/axis-deployer/2.1.5/car, is running.
Run DayTrader:
+
1. Go to http://<host>:8080/daytrader/
-1. Click on the _Configuration_ tab and click on _(Re)-create DayTrader
-Database Tables and Indexes_
-1. Click on the _Configuration _ tab and click on _(Re)-populate
-DayTrader Database_
+1. Click on the _Configuration_ tab and click on _(Re)-create DayTrader Database Tables and Indexes_
+1. Click on the _Configuration _ tab and click on _(Re)-populate DayTrader Database_
1. Click on the _Trading & Portfolios_ tab, login, and start trading
<a name="UsingCriteriaAPIinDayTrader-RunDayTraderonWebSphere"></a>
@@ -167,22 +121,23 @@ Download the following jython script. Th
objects needed by DayTrader (data sources, JMS queues and topics) and
install the application.
-[^daytrader_singleServer.py](^daytrader_singleserver.py.html)
+[daytrader_singleServer.py](artifacts/daytrader_singleserver.py)
Within the bin directory of the augmented profile:
+
1. Start the server.
-1. Run the script using the following command: "wsadmin \-f <location of
-daytrader_singleServer.py> <script options>". You can display the list of
-available script options by specifying the option "--help".
+1. Run the script using the following command:
+
+ wsadmin -f <location ofdaytrader_singleServer.py> <script options>
+
+ You can display the list of available script options by specifying the option "--help".
+
1. Re-start the server.
Run DayTrader
-1. On a web browser, go to http://localhost:<application port>/daytrader/
-(The default application port is 9080. But, you may have a different one if
-you created a new profile.)
-1. Click on the _Configuration_ tab and click on _(Re)-create DayTrader
-Database Tables and Indexes_
-1. Click on the _Configuration _ tab and click on _(Re)-populate
-DayTrader Database_
+
+1. On a web browser, go to http://localhost:<application port>/daytrader/(The default application port is 9080. But, you may have a different one if you created a new profile.)
+1. Click on the _Configuration_ tab and click on _(Re)-create DayTrader Database Tables and Indexes_
+1. Click on the _Configuration _ tab and click on _(Re)-populate DayTrader Database_
1. Click on the _Trading & Portfolios_ tab, login, and start trading