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