mirror of
https://github.com/berkeleydb/je.git
synced 2024-07-06 09:57:18 +00:00
48 lines
2.2 KiB
Plaintext
48 lines
2.2 KiB
Plaintext
JE provides a fully functional JMX MBean in com.sleepycat.je.jmx.JEMonitor.
|
|
To use this MBean, build and deploy jejmx.jar:
|
|
|
|
1. cd <jehome>
|
|
2. modify <jehome>/build.properties and set j2ee.jarfile to an
|
|
appropriate J2EE jar.
|
|
3. ant jmx
|
|
|
|
This builds a jejmx.jar in <jehome>/build/lib which contains the
|
|
MBean. A sample JBoss service descriptor can be found in
|
|
je-jboss-service.xml in this directory. The MBean can be deployed
|
|
by modifying the service file to point to a JE environment, and
|
|
then copying the service file, jejmx.jar, and je.jar to the JBoss
|
|
deployment directory.
|
|
|
|
JEMonitor expects another component in the JVM to configure and open
|
|
the JE environment; it will only access a JE environment that is
|
|
already active. It is intended for these use cases:
|
|
|
|
- The application wants to add database monitoring with minimal effort and
|
|
little knowledge of JMX. Configuring JEMonitor within the JMX container
|
|
provides monitoring without requiring application code changes.
|
|
|
|
- An application already supports JMX and wants to add database monitoring
|
|
without modifying its existing MBean. The user can configure JEMonitor in
|
|
the JMX container in conjunction with other application MBeans that are
|
|
non-overlapping with JE monitoring. No application code changes are
|
|
required.
|
|
|
|
Users may want to incorporate JE management functionality into their
|
|
own MBeans, expecially if their application configures and opens the
|
|
JE environment. This can be done by using the utility class
|
|
com.sleepycat.je.jmx.JEMBeanHelper and an example implementation,
|
|
com.sleepycat.je.JEApplicationMBean which is provided in this
|
|
directory. This MBean differs from JEMonitor by supporting environment
|
|
configuration and creation from within the MBean. JEApplicationMBean
|
|
may be deployed, or used as a starting point for an alternate
|
|
implementation. To build the example,
|
|
|
|
1. cd <jehome>
|
|
2. modify <jehome>/build.properties and set j2ee.jarfile to an
|
|
appropriate J2EE jar.
|
|
3. ant jmx-examples
|
|
|
|
This creates a jejmx-example.jar in <jehome>/build/lib that can be
|
|
copied to the appropriate deployment directory. See the
|
|
je-jboss-service.xml file for an example of how this might be done for JBoss.
|