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/07/11 00:50:25 UTC
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...
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 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor
+ license agreements. See the NOTICE file distributed with this work for additional
+ information regarding copyright ownership. The ASF licenses this file to
+ you under the Apache License, Version 2.0 (the "License"); you may not use
+ this file except in compliance with the License. You may obtain a copy of
+ the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required
+ by applicable law or agreed to in writing, software distributed under the
+ License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
+ OF ANY KIND, either express or implied. See the License for the specific
+ language governing permissions and limitations under the License. -->
+<!-- Maven release plugin requires the project tag to be on a single line. -->
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
+
+ <modelVersion>4.0.0</modelVersion>
+
+ <parent>
+ <groupId>org.apache.openjpa</groupId>
+ <artifactId>openjpa-tools</artifactId>
+ <version>2.3.0-SNAPSHOT</version>
+ </parent>
+
+ <artifactId>openjpa-fetch-statistics-was</artifactId>
+ <packaging>jar</packaging>
+
+ <name>OpenJPA Fetching Statistic Tool -- WAS Bundle</name>
+ <description> OpenJPA tool to capture the fetching statistic data for the persistent fields .</description>
+ <inceptionYear>2012</inceptionYear>
+
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.openjpa</groupId>
+ <artifactId>openjpa-fetch-statistics</artifactId>
+ <version>${project.version}</version>
+ </dependency>
+ </dependencies>
+
+ <licenses>
+ <license>
+ <name>Apache License 2.0</name>
+ <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
+ <distribution>repo</distribution>
+ </license>
+ </licenses>
+
+ <build>
+ <finalName>${artifactId}-${project.version}-no-dependencies</finalName>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-surefire-plugin</artifactId>
+ <configuration>
+ <argLine>${surefire.jvm.args}</argLine>
+ <excludes>
+ <!-- exclude the unit test since the fetch statistic enhancer cannot
+ be load during maven build -->
+ <exclude>org/apache/openjpa/enhance/stats/TestFetchStatistics.java</exclude>
+ </excludes>
+ </configuration>
+ </plugin>
+
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-shade-plugin</artifactId>
+ <version>1.7.1</version>
+ <executions>
+ <execution>
+ <phase>package</phase>
+ <goals>
+ <goal>shade</goal>
+ </goals>
+ <configuration>
+ <finalName>${artifactId}-${project.version}</finalName>
+ <artifactSet>
+ <includes>
+ <include>org.apache.openjpa:*statistics</include>
+ </includes>
+ </artifactSet>
+ <shadedArtifactAttached>false</shadedArtifactAttached>
+ <transformers>
+ <transformer
+ implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
+ <manifestEntries>
+ <Fragment-Host>com.ibm.ws.jpa; bundle-version=8.0.0</Fragment-Host>
+ <Export-Package>org.apache.openjpa.enhance.stats</Export-Package>
+ <Bundle-SymbolicName>org.apache.openjpa.enhance.stats; singleton:=true</Bundle-SymbolicName>
+ <Bundle-Name>FetchStatisticsAuxEnhancer</Bundle-Name>
+ </manifestEntries>
+ </transformer>
+ </transformers>
+ </configuration>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+</project>
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 @@
<name>OpenJPA Fetching Statistic Tool</name>
<description> OpenJPA tool to capture the fetching statistic data for the persistent fields .</description>
<inceptionYear>2012</inceptionYear>
-
+
<dependencies>
<dependency>
<groupId>org.apache.geronimo.specs</groupId>
@@ -62,7 +62,7 @@
<version>3.8.1</version>
</dependency>
</dependencies>
-
+
<licenses>
<license>
<name>Apache License 2.0</name>
@@ -85,48 +85,6 @@
</excludes>
</configuration>
</plugin>
- <plugin>
- <artifactId>maven-jar-plugin</artifactId>
- <executions>
- <execution>
- <id>default-jar</id>
- <goals>
- <goal>jar</goal>
- </goals>
- <phase>package</phase>
- <configuration>
- <excludes>
- <exclude>README-*.txt</exclude>
- </excludes>
- </configuration>
- </execution>
- <!-- Create another WAS specific jar -->
- <execution>
- <id>was</id>
- <goals>
- <goal>jar</goal>
- </goals>
- <phase>package</phase>
- <configuration>
- <finalName>${artifactId}-${version}-websphere</finalName>
- <archive>
- <manifest>
- <addDefaultImplementationEntries>true</addDefaultImplementationEntries>
- </manifest>
- <manifestEntries>
- <Fragment-Host>com.ibm.ws.jpa; bundle-version=8.0.0</Fragment-Host>
- <Export-Package>org.apache.openjpa.enhance.stats</Export-Package>
- <Bundle-SymbolicName>org.apache.openjpa.enhance.stats; singleton:=true</Bundle-SymbolicName>
- <Bundle-Name>FetchStatisticsAuxEnhancer</Bundle-Name>
- </manifestEntries>
- </archive>
- <excludes>
- <exclude>README.txt</exclude>
- </excludes>
- </configuration>
- </execution>
- </executions>
- </plugin>
</plugins>
</build>
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-<version>-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 @@
<modules>
<module>openjpa-maven-plugin</module>
<module>openjpa-fetch-statistics</module>
-
+ <module>openjpa-fetch-statistics-was</module>
</modules>
<profiles>