openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From curti...@apache.org
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 GMT
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>



Mime
View raw message