db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Db-derby Wiki] Update of "DerbyJMX" by JohnHEmbretsen
Date Tue, 25 Mar 2008 15:12:52 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Db-derby Wiki" for change notification.

The following page has been changed by JohnHEmbretsen:
http://wiki.apache.org/db-derby/DerbyJMX

The comment on the change is:
Updated MBean object names and added generic Jira reference

------------------------------------------------------------------------------
  
  = Jira issues =
  
+ [http://issues.apache.org/jira/browse/DERBY Jira] is the issue tracking system used by the
Apache Derby project. Here is a list of some of the issues relating to JMX:
+ 
   * [https://issues.apache.org/jira/browse/DERBY-1387 DERBY-1387] - Add JMX extensions to
Derby
   * [https://issues.apache.org/jira/browse/DERBY-3385 DERBY-3385] - Tests for JMX Management
and Monitoring
   * [https://issues.apache.org/jira/browse/DERBY-3424 DERBY-3424] - Add a management MBean
to control JMX state
   * [https://issues.apache.org/jira/browse/DERBY-3429 DERBY-3429] - Remove system property
derby.system.jmx
   * [https://issues.apache.org/jira/browse/DERBY-3435 DERBY-3435] - Add an MBean for monitoring
and managing the Network Server
+ 
+ There is a separate JMX component for Derby in Jira. Search for [http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&mode=hide&pid=10594&sorter/order=DESC&sorter/field=priority&resolution=-1&component=12312171
issues with the JMX component] to get an updated list of all JMX related issues.
  
  = Generic JMX technology resources =
  
@@ -43, +47 @@

  = Current MBeans =
  
  Each Derby MBean is defined by a Java interface in the package `org.apache.derby.mbeans`
or any of its subpackages. 
+  * MBeans in the top-level `mbeans` package are included in '''derby.jar''' and are located
in the `java/engine` source tree. 
+  * MBeans in the `org.apache.derby.mbeans.drda` package are included in '''derbynet.jar'''
and are located in the `java/drda` source tree.
+  * Other subpackages may be added later (e.g. `tools`).
  
+ The object name of each Derby MBean should be well-defined, and documented in the MBean
interface's public Javadoc. Every Derby MBean is associated with the domain `org.apache.derby`
and includes at least the following key-properties:
+  * `type` - Typically the class name of the MBean's interface class without the package
and without MBean. For example for `org.apache.derby.mbeans.VersionMBean` the key property
`type` will be set to `Version`.
+  * `system` - A runtime identifier that allows Derby and applications to disambiguate multiple
Derby systems in the same virtual machine but different class loaders. See the [http://db.apache.org/derby/javadoc/publishedapi/jdbc3/org/apache/derby/mbeans/package-summary.html
org.apache.derby.mbeans package Javadoc overview] for details. In the MBean descriptions below,
the system identifier is represented by the variable `<sysID>`. The value will vary
between each time Derby is run, and will look like a multi-digit hexadecimal number such as
a [http://en.wikipedia.org/wiki/Globally_Unique_Identifier GUID].
- MBeans in the top-level `mbeans` package are included in '''derby.jar''' and are located
in the `java/engine` source tree. 
- 
- MBeans in the `org.apache.derby.mbeans.drda` package are included in '''derbynet.jar'''
and are located in the `java/drda` source tree.
- 
- Other subpackages may be added later (e.g. `tools`).
  
  == VersionMBean ==
   * `org.apache.derby.mbeans.VersionMBean`
   * '''Implementation:''' `org.apache.derby.iapi.services.info.Version` (not public)
   * '''!ObjectName:''' 
-     * `org.apache.derby:type=Version,jar=derby.jar` (monitors derby.jar (the engine)), '''or'''
+     * `org.apache.derby:type=Version,system=<sysID>,jar=derby.jar` (monitors derby.jar
(the engine)), '''or'''
-     * `org.apache.derby:type=Version,jar=derbynet.jar` (monitors derbynet.jar (the server))
+     * `org.apache.derby:type=Version,system=<sysID>,jar=derbynet.jar` (monitors derbynet.jar
(the server))
   * '''Instruments:'''
     * `org.apache.derby.iapi.services.info.ProductVersionHolder`
   * '''Status:''' In trunk (since 2008-02-12)
@@ -65, +70 @@

  
   * `org.apache.derby.mbeans.JDBCMBean`
   * '''Implementation:''' `org.apache.derby.jdbc.JDBC` (not public)
-  * '''!ObjectName:''' `org.apache.derby:type=JDBC`
+  * '''!ObjectName:''' `org.apache.derby:type=JDBC,system=<sysID>`
   * '''Instruments:'''
     * `org.apache.derby.jdbc.InternalDriver`
     * `org.apache.derby.iapi.services.info.JVMInfo`
@@ -81, +86 @@

     * '''Implementation''':
       * `org.apache.derby.impl.services.jmx.JMXManagementService` (not public)
       * `org.apache.derby.impl.services.jmxnone.NoManagementService` (not public) [empty
implementation for environments without the required JMX support]
-  * '''!ObjectName:''' `org.apache.derby:type=Management` when registered by Derby
+  * '''!ObjectName:''' `org.apache.derby:type=Management,system=<sysID>` when registered
by Derby
   * '''Instruments:'''
     * `org.apache.derby.impl.services.jmx.JMXManagementService`
   * '''Status:''' In trunk (since 2008-02-15)
@@ -91, +96 @@

  
   * `org.apache.derby.mbeans.drda.NetworkServerMBean`
   * '''Implementation:''' `org.apache.derby.impl.drda.NetworkServerMBeanImpl` (not public)
-  * '''!ObjectName:''' `org.apache.derby:type=NetworkServer`
+  * '''!ObjectName:''' `org.apache.derby:type=NetworkServer,system=<sysID>`
   * '''Instruments:'''
     * `org.apache.derby.impl.drda.NetworkServerControlImpl`
   * '''Status:''' In trunk (since 2008-02-20)

Mime
View raw message