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. |