EclipseLink/DesignDocs/235168

Design Specification: JMX MBean Support

235168

Document History

Date	Author	Version Description & Notes
2008-06-23	Michael O	0.1 Starting Draft

Project overview

This enhancement will add JMX MBean support to EclipseLink 1.0 by exposing runtime and

Goals:

Concepts

Based on JMX 1.2 and JMX Remote API 1.0

References

ELUG Documentation JMX MBeans in WebLogic 10

Requirements

Phase 1: WebLogic 10 MBean support

• R1: Enable JMX MBean Support for WebLogic
  • R1.1: Enable predeploy MBean registration
  • R1.2: Enable application managed lazy-load MBean registration (post-deploy)

Phase 2: Generic MBean support

• • R2: Enable JMX MBean support for generic J2EE servers

Design / Functionality

Lazy Registration

Here the application can manage registration/deregistration of the MBeans by using a SessionCustomizer in conjunction with a listener on either a servlet or session bean within the JEE application.

• SessionCustomizer

• Listener

You must configure the EclipseLink Mbeans in the EAR/meta-inf via a weblogic-application.xml descriptor entry.

<!DOCTYPE application PUBLIC "-//Sun Microsystems, Inc.//DTD J2EE Application 1.3//EN"  "http://java.sun.com/dtd/application_1_3.dtd">
<weblogic-application xmlns="http://www.bea.com/ns/weblogic/10">
    <listener>
       <listener-class>org.eclipse.persistence.example.unified.integration.ApplicationLifecycleListenerImpl</listener-class>
    </listener>
</weblogic-application>

Testing

A formal JMX J2SE client test suite is required.

=

Open Issues

Issue #	Owner	Description / Notes

Decisions

Issue #	Description / Notes	Decision

Future Considerations

During the research for this project the following items were identified as out of scope but are captured here as potential future enhancements. If agreed upon during the review process these should be logged in the bug system.

• OC4J specific MBean support