db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "John H. Embretsen (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DERBY-3540) Document the JMX management and monitoring functionality
Date Fri, 04 Apr 2008 14:37:24 GMT

     [ https://issues.apache.org/jira/browse/DERBY-3540?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

John H. Embretsen updated DERBY-3540:
-------------------------------------

    Attachment: ctunsetprop824983.html
                cadminconfig86869.html
                DERBY-3540-2.diff

Thank you Kim for working on this!

Some comments:

 - The statement that it is possible to manage the Network Server using JMX is hardly true,
as the current MBean only provides monitoring features. I suggest at least adding the word
"monitoring" to that statement, which is what I have done in the attached patch ("DERBY-3540-2.diff").
I leave it to you to decide if we should leave the word "manage" in or not... (I still think
the paragraph should be added, as monitoring and management are closely related topics). New
version attached as html, cadminconfig86869.html.

- I found a place in the Tuning guide that may be worthy of a mention of JMX: Verifying System
Properties (ctunsetprop824983.html). I added a paragraph in the attached patch, saying: "You
can also use Java Management Extensions (JMX) technology to obtain system information, including
some settings that correspond to system properties." and adding the references you added in
the other places.

- In the attached patch I also added some information about security policy permissions relating
to JMX and derby.jar to the Develeopers Guide, see cdevbabejgjd.html.


To answer your question: Yes, JMX applies also to embedded mode. 
But I do think the places you found are enough for 10.4.1, possibly with the addition of the
extra stuff I added in this patch version 2. Referencing the wiki from the manuals is sketchy
enough, and I didn't find any other good places to add this information either, so let's hope
we can do better for the next release instead :)

> Document the JMX management and monitoring functionality
> --------------------------------------------------------
>
>                 Key: DERBY-3540
>                 URL: https://issues.apache.org/jira/browse/DERBY-3540
>             Project: Derby
>          Issue Type: Improvement
>          Components: Documentation, JMX
>    Affects Versions: 10.4.0.0
>            Reporter: John H. Embretsen
>            Assignee: Kim Haase
>         Attachments: cadminconfig86869.html, cadminconfig86869.html, ctunsetprop824983.html,
DERBY-3540-1.diff, DERBY-3540-2.diff, tadminconfigsysteminformation.html
>
>
> Brand new management and monitoring capabilities using JMX were starting to be added
to Derby in the first calendar quarter of 2008. This issue tracks efforts documenting this
functionality.
> A JMX M&M functional specification document (funcSpec.html) is attached to DERBY-1387.
More information may be available on the wiki - http://wiki.apache.org/db-derby/DerbyJMX -
and in JMX-related Javadocs ("published API") (packages org.apache.derby.mbeans and org.apache.derby.mbeans.drda).

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message