svn commit: r883825 - /incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml

[sc...@apache.org]

Author: schor
Date: Tue Nov 24 19:19:34 2009
New Revision: 883825

URL: http://svn.apache.org/viewvc?rev=883825&view=rev
Log:
UIMA-1677 doc updates re: JMX starting

Modified:
    incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml

Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml?rev=883825&r1=883824&r2=883825&view=diff
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.application.xml Tue Nov 24 19:19:34 2009
@@ -1719,25 +1719,17 @@
       JVM that supports JMX, the UIMA framework will automatically detect the presence of JMX and will register
       <emphasis>MBeans</emphasis> that provide access to the performance statistics.</para>
     
-    <para>To enable remote monitoring of these performance statistics, when you start your UIMA application
-      specify the following JVM parameter: <literal>-Dcom.sun.management.jmxremote</literal></para>
-    
-    <para>Now, you can use any JMX client to view the statistics. JDK 5.0 provides a standard client that you can use.
-      Simply open a command prompt, make sure the JDK 5.0 <literal>bin</literal> directory is in your path, and
-      execute the <literal>jconsole</literal> command. This should bring up the following window:
-      
-      
-      <screenshot>
-    <mediaobject>
-      <imageobject>
-        <imagedata width="3.5in" format="JPG" fileref="&imgroot;image004.jpg"/>
-      </imageobject>
-      <textobject><phrase>Screenshot of JMX console</phrase></textobject>
-    </mediaobject>
-  </screenshot></para>
-    
-    <para>Here you can choose from among your JMX-enabled applications that are currently running. Select a UIMA
-      application from the list and click <quote>Connect</quote>. The next screen will show a summary of
+    <para>Note: The Sun JVM supports local monitoring; for others you can configure your
++      application for remote monitoring (even when on the same host) by specifying a unique port number, e.g.
++      <literal>-Dcom.sun.management.jmxremote.port=1098
++      -Dcom.sun.management.jmxremote.authenticate=false
++      -Dcom.sun.management.jmxremote.ssl=false</literal></para>
+    
+    <para>Now, you can use any JMX client to view the statistics. JDK 5.0 or later provides a standard client that you can use.
+      Simply open a command prompt, make sure the JDK <literal>bin</literal> directory is in your path, and
+      execute the <literal>jconsole</literal> command. This should bring up a window allowing you to
+      select one of the local JMX-enabled applications currently running, or to enter a remote (or local) host and
+      port, e.g. localhost:1098.  The next screen will show a summary of
       information about the Java process that you connected to. Click on the <quote>MBeans</quote> tab, then expand
       <quote>org.apache.uima</quote> in the tree at the left. You should see a view like this: