Return-Path: X-Original-To: apmail-openjpa-commits-archive@www.apache.org Delivered-To: apmail-openjpa-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 907C29001 for ; Tue, 10 Jul 2012 22:50:50 +0000 (UTC) Received: (qmail 68717 invoked by uid 500); 10 Jul 2012 22:50:50 -0000 Delivered-To: apmail-openjpa-commits-archive@openjpa.apache.org Received: (qmail 68696 invoked by uid 500); 10 Jul 2012 22:50:50 -0000 Mailing-List: contact commits-help@openjpa.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@openjpa.apache.org Delivered-To: mailing list commits@openjpa.apache.org Received: (qmail 68685 invoked by uid 99); 10 Jul 2012 22:50:50 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 10 Jul 2012 22:50:50 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 10 Jul 2012 22:50:46 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 8F943238897F for ; Tue, 10 Jul 2012 22:50:25 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1359941 - in /openjpa/trunk/openjpa-tools: ./ openjpa-fetch-statistics-was/ openjpa-fetch-statistics-was/src/ openjpa-fetch-statistics-was/src/main/ openjpa-fetch-statistics-was/src/main/resources/ openjpa-fetch-statistics/ openjpa-fetch-s... Date: Tue, 10 Jul 2012 22:50:25 -0000 To: commits@openjpa.apache.org From: curtisr7@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20120710225025.8F943238897F@eris.apache.org> Author: curtisr7 Date: Tue Jul 10 22:50:24 2012 New Revision: 1359941 URL: http://svn.apache.org/viewvc?rev=1359941&view=rev Log: OPENJPA-2220: Break fetch statistics apart into multiple dependent modules. Added: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/ (with props) openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/pom.xml (with props) openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/ (with props) openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/ (with props) openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/resources/ (with props) openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/resources/README.txt (with props) Removed: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/src/main/resources/README-WEBSPHERE.txt Modified: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/pom.xml openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/src/main/resources/README.txt openjpa/trunk/openjpa-tools/pom.xml Propchange: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/ ------------------------------------------------------------------------------ svn:eol-stype = native Added: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/pom.xml URL: http://svn.apache.org/viewvc/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/pom.xml?rev=1359941&view=auto ============================================================================== --- openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/pom.xml (added) +++ openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/pom.xml Tue Jul 10 22:50:24 2012 @@ -0,0 +1,98 @@ + + + + + + 4.0.0 + + + org.apache.openjpa + openjpa-tools + 2.3.0-SNAPSHOT + + + openjpa-fetch-statistics-was + jar + + OpenJPA Fetching Statistic Tool -- WAS Bundle + OpenJPA tool to capture the fetching statistic data for the persistent fields . + 2012 + + + + org.apache.openjpa + openjpa-fetch-statistics + ${project.version} + + + + + + Apache License 2.0 + http://www.apache.org/licenses/LICENSE-2.0.txt + repo + + + + + ${artifactId}-${project.version}-no-dependencies + + + org.apache.maven.plugins + maven-surefire-plugin + + ${surefire.jvm.args} + + + org/apache/openjpa/enhance/stats/TestFetchStatistics.java + + + + + + org.apache.maven.plugins + maven-shade-plugin + 1.7.1 + + + package + + shade + + + ${artifactId}-${project.version} + + + org.apache.openjpa:*statistics + + + false + + + + com.ibm.ws.jpa; bundle-version=8.0.0 + org.apache.openjpa.enhance.stats + org.apache.openjpa.enhance.stats; singleton:=true + FetchStatisticsAuxEnhancer + + + + + + + + + + Propchange: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/pom.xml ------------------------------------------------------------------------------ svn:eol-stype = native Propchange: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/ ------------------------------------------------------------------------------ svn:eol-stype = native Propchange: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/ ------------------------------------------------------------------------------ svn:eol-stype = native Propchange: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/resources/ ------------------------------------------------------------------------------ svn:eol-stype = native Added: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/resources/README.txt URL: http://svn.apache.org/viewvc/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/resources/README.txt?rev=1359941&view=auto ============================================================================== --- openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/resources/README.txt (added) +++ openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/resources/README.txt Tue Jul 10 22:50:24 2012 @@ -0,0 +1,31 @@ +Apache OpenJPA - README.txt +Licensed under Apache License 2.0 - http://www.apache.org/licenses/LICENSE-2.0 +-------------------------------------------------------------------------------- + +WebSphere Instructions -- + +Open JPA Fetch Statistics Tool monitors persistent field access and determines which fields are never used. This tool +can be used to help tune an application. + +Note: Open JPA Fetching Statistics Tool works with the runtime enhancement. + +Usage instructions: + +1.] Configuration + * Add openjpa-fetch-statistics-[VERSION]-websphere.jar into the [WAS_HOME]\plugins directory. + * Run [WAS_HOME]\bin\osgiCfgInit.sh(bat) to clear the osgi cache. + +2.] Statistics Collecting and Monitoring + * 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. Any field that is logged + has not been accessed by an application. + +3.] Configuration removal + * Stop all WebSphere processes using the [WAS_HOME]\plugins installation. + * Remove the openjpa-fetch-statistics-[VERSION]-websphere.jar jar from the [WAS_HOME]\plugins directory. + * Run [WAS_HOME]\bin\osgiCfgInit.sh(bat) to clear the osgi cache. + +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. Propchange: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics-was/src/main/resources/README.txt ------------------------------------------------------------------------------ svn:eol-stype = native Modified: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/pom.xml URL: http://svn.apache.org/viewvc/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/pom.xml?rev=1359941&r1=1359940&r2=1359941&view=diff ============================================================================== --- openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/pom.xml (original) +++ openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/pom.xml Tue Jul 10 22:50:24 2012 @@ -27,7 +27,7 @@ OpenJPA Fetching Statistic Tool OpenJPA tool to capture the fetching statistic data for the persistent fields . 2012 - + org.apache.geronimo.specs @@ -62,7 +62,7 @@ 3.8.1 - + Apache License 2.0 @@ -85,48 +85,6 @@ - - maven-jar-plugin - - - default-jar - - jar - - package - - - README-*.txt - - - - - - was - - jar - - package - - ${artifactId}-${version}-websphere - - - true - - - com.ibm.ws.jpa; bundle-version=8.0.0 - org.apache.openjpa.enhance.stats - org.apache.openjpa.enhance.stats; singleton:=true - FetchStatisticsAuxEnhancer - - - - README.txt - - - - - Modified: openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/src/main/resources/README.txt URL: http://svn.apache.org/viewvc/openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/src/main/resources/README.txt?rev=1359941&r1=1359940&r2=1359941&view=diff ============================================================================== --- openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/src/main/resources/README.txt (original) +++ openjpa/trunk/openjpa-tools/openjpa-fetch-statistics/src/main/resources/README.txt Tue Jul 10 22:50:24 2012 @@ -2,51 +2,15 @@ Apache OpenJPA - README.txt Licensed under Apache License 2.0 - http://www.apache.org/licenses/LICENSE-2.0 -------------------------------------------------------------------------------- -Open JPA Fetching Statistics Tool monitors the persistent fields -fetching and finds out the fields which are never accessed. Based on the -statistic data, user can set the field access type to LAZY to improve the -performance by eliminating the data loading and processing time. - -Note: Open JPA Fetching Statistics Tool works with the runtime enhancement. - -Usage instructions: - -1 Classpath Configuration - - Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar file - to the classpath of the application before starting the application. - -2 Statistics Collecting and Monitoring - - Start the application with openjpa-fetch-statistics--SNAPSHOT.jar - in the classpath. The tool will start collecting the statistics of the - persistent field fetching and output the list of the persistent fields - which have never been fetched to the log file every ten minutes.It will - output the last list when the JVM is shutdown. - -3 Termination - Shut down the JVM to stop the fetching statistics collecting. - Roll back the classpath configuration. - Start the application without the fetching statistics jar in the classpath - -Performance Consideration - -There will be performance impact when the fetching statistics collection is on. -The recommendation is to use it in the testing environment. - -Apache OpenJPA - README.txt -Licensed under Apache License 2.0 - http://www.apache.org/licenses/LICENSE-2.0 --------------------------------------------------------------------------------- - Open JPA Fetch Statistics Tool monitors persistent field access and determines which fields are never used. This tool can be used to help tune an application. Note: Open JPA Fetching Statistics Tool works with the runtime enhancement. -Usage instructions: +JSE usage instructions: 1.] Configuration - * Append the path of openjpa-fetch-statistics-version-SNAPSHOT.jar file to the classpath prior to lanuching the JVM. + * Append the path of openjpa-fetch-statistics-[version].jar file to the classpath prior to lanuching the JVM. 2.] Statistics Collecting and Monitoring * When this tool is configured, it will be active for all persistence units in the JVM. Statistics will be dumped via the @@ -55,7 +19,7 @@ Usage instructions: 3.] Configuration removal * Stop the JVM. - * Remove openjpa-fetch-statistics-version-SNAPSHOT.jar from the classpath. + * Remove openjpa-fetch-statistics-[version].jar from the classpath. Performance Consideration Modified: openjpa/trunk/openjpa-tools/pom.xml URL: http://svn.apache.org/viewvc/openjpa/trunk/openjpa-tools/pom.xml?rev=1359941&r1=1359940&r2=1359941&view=diff ============================================================================== --- openjpa/trunk/openjpa-tools/pom.xml (original) +++ openjpa/trunk/openjpa-tools/pom.xml Tue Jul 10 22:50:24 2012 @@ -44,7 +44,7 @@ openjpa-maven-plugin openjpa-fetch-statistics - + openjpa-fetch-statistics-was