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

Reply via email to