Author: ochikvina
Date: 2010-05-27 05:31:25 -0400 (Thu, 27 May 2010)
New Revision: 22365
Modified:
trunk/jmx/docs/reference/en-US/master_output.xml
Log:
<html><head><meta name="qrichtext" content="1"
/></head><body style="font-size:9pt;font-family:Sans Serif">
<
p>https://jira.jboss.org/browse/TOOLSDOC-81 -Generated master_output.xml
file.</p>
</body></html>
Modified: trunk/jmx/docs/reference/en-US/master_output.xml
===================================================================
--- trunk/jmx/docs/reference/en-US/master_output.xml 2010-05-27 09:15:38 UTC (rev 22364)
+++ trunk/jmx/docs/reference/en-US/master_output.xml 2010-05-27 09:31:25 UTC (rev 22365)
@@ -2,15 +2,15 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.docbook.org/xml/4.3/docbookx.dtd"
-[<!ENTITY introduction SYSTEM "modules/introduction.xml">
-<!ENTITY mbean_explorer SYSTEM "modules/mbean_explorer.xml">
-<!ENTITY mbean_editor SYSTEM "modules/mbean_editor.xml">
-<!ENTITY connection SYSTEM "modules/connection.xml">
-<!ENTITY how_to SYSTEM "modules/how_to.xml">
-<!ENTITY extensions SYSTEM "modules/extensions.xml">
-<!ENTITY tasks SYSTEM "modules/tasks.xml">
-<!ENTITY references SYSTEM "modules/references.xml">
-<!ENTITY summary SYSTEM "modules/summary.xml">
+[<!ENTITY introduction SYSTEM "introduction.xml">
+<!ENTITY mbean_explorer SYSTEM "mbean_explorer.xml">
+<!ENTITY mbean_editor SYSTEM "mbean_editor.xml">
+<!ENTITY connection SYSTEM "connection.xml">
+<!ENTITY how_to SYSTEM "how_to.xml">
+<!ENTITY extensions SYSTEM "extensions.xml">
+<!ENTITY tasks SYSTEM "tasks.xml">
+<!ENTITY references SYSTEM "references.xml">
+<!ENTITY summary SYSTEM "summary.xml">
<!ENTITY seamlink "../../seam/html_single/index.html">
<!ENTITY aslink "../../as/html_single/index.html">
<!ENTITY esblink "../../esb_ref_guide/html_single/index.html">
@@ -48,7 +48,7 @@
<holder>JBoss by Red Hat</holder>
</copyright>
<releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 1.1.0.GA
+ Version: 1.1.1.GA
</diffmk:wrapper></releaseinfo>
<abstract>
<title></title>
@@ -60,19 +60,47 @@
<toc></toc>
-<chapter id="intruduction"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jmx/docs/reference/en/modules/introduction.xml"
xreflabel="introduction">
+<chapter id="intruduction"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jmx/docs/reference/en-US/introduction.xml"
xreflabel="introduction">
<?dbhtml filename="introduction.html"?>
<title>Introduction</title>
<para><property moreinfo="none">JBoss Tools</property>'
JMX project is a fork of <ulink
url="http://code.google.com/p/eclipse-jmx/">eclipse-jmx</...;, a
project by Jeff Mesnil.
It was forked with permission. </para>
+
+ <section diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">What is JMX?</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+The Java Management Extensions (JMX) technology is a standard part of the Java Platform,
Standard Edition (Java SE platform). The JMX technology was added to the platform in the
Java 2 Platform, Standard Edition (J2SE) 5.0 release.
+</diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+The JMX technology provides a simple, standard way of managing resources such as
applications, devices, and services. Because the JMX technology is dynamic, you can use it
to monitor and manage resources as they are created, installed and implemented. You can
also use the JMX technology to monitor and manage the Java Virtual Machine (Java VM).
+</diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+The JMX specification defines the architecture, design patterns, APIs, and services in
the Java programming language for management and monitoring of applications and networks.
+</diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+Using the JMX technology, a given resource is instrumented by one or more Java objects
known as Managed Beans, or MBeans. These MBeans are registered in a core-managed object
server, known as an MBean server. The MBean server acts as a management agent and can run
on most devices that have been enabled for the Java programming language.
+</diffmk:wrapper></para>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+The specifications define JMX agents that you use to manage any resources that have been
correctly configured for management. A JMX agent consists of an MBean server, in which
MBeans are registered, and a set of services for handling the MBeans. In this way, JMX
agents directly control resources and make them available to remote management
applications.
+</diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+The way in which resources are instrumented is completely independent from the management
infrastructure. Resources can therefore be rendered manageable regardless of how their
management applications are implemented.
+</diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+The JMX technology defines standard connectors (known as JMX connectors) that enable you
to access JMX agents from remote management applications. JMX connectors using different
protocols provide the same management interface. Consequently, a management application
can manage resources transparently, regardless of the communication protocol used. JMX
agents can also be used by systems or applications that are not compliant with the JMX
specification, as long as those systems or applications support JMX agents.
+</diffmk:wrapper></para>
+<ulink diffmk:change="added"
url="http://java.sun.com/docs/books/tutorial/jmx/overview/index.html...
diffmk:change="added">Read more about
JMX</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">.
+ </diffmk:wrapper></section>
+
<section>
<title>What is JMX Tools?</title>
- <para><property moreinfo="none">JMX Tools</property>
allows to setup multiple JMX connections and provides view
- for exploring the JMX tree and execute operations directly from
Eclipse.</para>
+ <para><property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss JMX
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed"> allow to setup multiple JMX connections and provide
view
+ for exploring the JMX tree and execute operations directly from
Eclipse.</diffmk:wrapper></para>
- <para>This chapter covers the basics of working with <property
moreinfo="none">JMX plugin</property>, which is
- used to manage Java applications through JMX and its RMI Connector.</para>
+ <para>This chapter covers the basics of working with <property
moreinfo="none">JMX plugin</property><diffmk:wrapper
diffmk:change="changed">, which is
+ used to manage Java applications (with Managed Beans) through JMX and its RMI
Connector.</diffmk:wrapper></para>
<figure float="0">
<title>JMX Tools</title>
@@ -85,10 +113,10 @@
</section>
<section><title>Key Features of JMX Tools</title>
- <para>For a start, we propose you to look through the table of main features of
JMX Tools:</para>
+ <para><diffmk:wrapper diffmk:change="changed">For a start, we
propose you to look through the table of main features of JBoss JMX
Tools:</diffmk:wrapper></para>
<table>
- <title>Key Functionality for JMX Tools</title>
+ <title><diffmk:wrapper diffmk:change="changed">Key
Functionality for JBoss JMX Tools</diffmk:wrapper></title>
<tgroup cols="3">
<colspec align="left" colnum="1"
colwidth="2*"></colspec>
@@ -129,14 +157,14 @@
<title>Requirements and Installation</title>
<section>
<title> Requirements</title>
- <para>Requirements to use <property moreinfo="none">JMX
Tools</property> are the following:</para>
+ <para>Requirements to use <property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
JMX Tools</diffmk:wrapper></property> are the following:</para>
<itemizedlist>
<listitem>
- <para><property moreinfo="none">JMX Tools</property>
is developed on Eclipse 3.4.x milestones</para>
+ <para><property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss JMX
Tools</diffmk:wrapper></property> is developed on Eclipse 3.4.x
milestones</para>
</listitem>
<listitem>
- <para><property moreinfo="none">JMX Tools</property>
requires that Eclipse is run on a JDK 1.5.0 or above
+ <para><property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss JMX
Tools</diffmk:wrapper></property> requires that Eclipse is run on a JDK 1.5.0
or above
(due to dependencies on JMX packages which were introduced in Java
1.5.0)</para>
</listitem>
</itemizedlist>
@@ -146,23 +174,22 @@
<para>Here, we are going to explain how to install the <property
moreinfo="none">JMX plugin</property> into
Eclipse.</para>
- <para><property moreinfo="none">JMX Tools</property> is
one module of the <property moreinfo="none">JBoss Tools</property>
- project. <property moreinfo="none">JMX Tools</property> has
no dependency on any other part of <property moreinfo="none">JBoss
- Tools</property>, and can be downloaded standalone. Even though the
<property moreinfo="none">JMX
- Tools</property> have no dependencies, other plugins, such as <property
moreinfo="none">AS Tools</property>,
- do depend on the JMX Tooling and even extend it. </para>
+ <para><property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss JMX
Tools</diffmk:wrapper></property> is one module of the <property
moreinfo="none">JBoss Tools</property>
+ project. <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed"> JBoss JMX
Tools</diffmk:wrapper></property> has no dependency on any other part of
<property moreinfo="none">JBoss
+ Tools</property><diffmk:wrapper diffmk:change="changed">,
and can be downloaded as a standalone Eclipse plugin. Even though the
</diffmk:wrapper><property moreinfo="none">JMX
+ Tools</property><diffmk:wrapper diffmk:change="changed">
have no dependencies on other plugins, such as </diffmk:wrapper><property
moreinfo="none">AS Tools</property><diffmk:wrapper
diffmk:change="added">,
+ </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
JMX Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> do depend on the JMX Tooling and even extend it.
</diffmk:wrapper></para>
- <para>You can find the <property moreinfo="none">JBoss
Tools</property> plugins over at the <ulink
url="http://labs.jboss.com/tools/download.html">download pages</ulink>.
The only
- package you'll need to get is the JMX Tooling, however the <property
moreinfo="none">AS
- Tools</property> would give you a more full experience when using JMX with
JBoss Servers.
- You can find further download and installation instructions on the JBoss Wiki in
the <ulink
url="http://labs.jboss.com/wiki/InstallingJBossTools">Instal...
+ <para>You can find the <property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
JBoss Tools</diffmk:wrapper></property> plugins over at the <ulink
url="http://labs.jboss.com/tools/download.html">download
pages</ulink><diffmk:wrapper diffmk:change="changed">. The only
+ package you'll need to get is the JBoss JMX Tooling, however the
</diffmk:wrapper><property moreinfo="none">AS
+ Tools</property><diffmk:wrapper diffmk:change="changed">
would give you a wider experience and more options when using JMX with JBoss Servers.
+ You can find further download and installation instructions on the JBoss Wiki in
the </diffmk:wrapper><ulink
url="http://www.jboss.org/tools/download/installation">Insta...
section.</para>
</section>
</section>
-</chapter>
-
-<chapter id="tasks"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jmx/docs/reference/en/modules/tasks.xml"
xreflabel="tasks">
+</chapter>
+<chapter id="tasks"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jmx/docs/reference/en-US/tasks.xml"
xreflabel="tasks">
<?dbhtml filename="tasks.html"?>
<title>JMX Tools Tasks</title>
<para>This chapter will give you answers on most popular questions asked by
<property moreinfo="none">JMX
@@ -170,12 +197,12 @@
<section>
<title>Quick Start</title>
- <para>To start using the <property moreinfo="none">JMX
Tools</property>, it's necessary to open
- <property moreinfo="none">MBean Explorer</property>. Go
to <emphasis><property moreinfo="none">Window > Show View
> Other</property></emphasis> and then select
+ <para>To start using the <property moreinfo="none">JMX
Tools</property><diffmk:wrapper diffmk:change="changed"> it's
necessary to open
+ </diffmk:wrapper><property moreinfo="none">MBean
Explorer</property>. Go to <emphasis><property
moreinfo="none">Window > Show View >
Other</property></emphasis> and then select
<property moreinfo="none">MBean Explorer</property> and
click <emphasis><property
moreinfo="none">OK</property>.</emphasis></para>
- <para>The <property moreinfo="none">MBean
Explorer</property> lists all of the domains, mbeans, attributes, and operations
inside a
- connection. When you double-click on a MBean in the
<emphasis><property moreinfo="none">MBean
Explorer</property>,</emphasis> it opens a multi-page
+ <para>The <property moreinfo="none">MBean
Explorer</property><diffmk:wrapper diffmk:change="changed"> lists
all the domains, mbeans, attributes, and operations inside a
+ connection. When you double-click a MBean in the
</diffmk:wrapper><emphasis><property moreinfo="none">MBean
Explorer</property>,</emphasis> it opens a multi-page
editor to manage the MBean. The <property
moreinfo="none">MBean Editor</property> is composed of these
pages:</para>
<itemizedlist>
@@ -194,6 +221,102 @@
</itemizedlist>
</section>
+
+ <section diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Managing
Application</diffmk:wrapper></title>
+
+
+
+<para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">As it's been said earlier in the guide the JMX
technology allows to monitor and manage Java applications. In this section we will show
you how to get connected to
+a sample Java application and run the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">sayHello()</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> method remotely from inside of the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">MBean
Explorer</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+<orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore"><diffmk:wrapper diffmk:change="added">
+
+http://java.sun.com/docs/books/tutorial/jmx/examples/jmx_examples.zip
+
+</diffmk:wrapper><listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Save the bundle of JMX API sample classes,
</diffmk:wrapper><ulink diffmk:change="added"
url="http://java.sun.com/docs/books/tutorial/jmx/examples/jmx_exampl...
diffmk:change="added">jmx_examples.zip</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">, to your working
directory</diffmk:wrapper></para></listitem>
+<listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Unzip the bundle of sample
classes.</diffmk:wrapper></para></listitem>
+<listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Compile the example Java classes from within where you
unpacked the files directory.</diffmk:wrapper></para>
+
+ <programlisting diffmk:change="added"
format="linespecific" role="XML"><diffmk:wrapper
diffmk:change="added"><![CDATA[
+ javac com/example/*.java
+ ]]></diffmk:wrapper></programlisting>
+
+</listitem>
+<listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Start the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Main</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> application, specifying the properties that expose
Main for remote management:</diffmk:wrapper></para>
+
+ <programlisting diffmk:change="added"
format="linespecific" role="XML"><diffmk:wrapper
diffmk:change="added"><![CDATA[
+java -Dcom.sun.management.jmxremote.port=9999 \
+-Dcom.sun.management.jmxremote.authenticate=false \
+-Dcom.sun.management.jmxremote.ssl=false \
+com.example.Main
+ ]]></diffmk:wrapper></programlisting>
+
+<para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">If everything was done correctly you will see the
"Waiting for incoming requests..." message on the
screen.</diffmk:wrapper></para>
+
+
+ </listitem>
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Now launch the Eclipse IDE, in Eclipse open the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">MBean
Explorer</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">. Go to </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Window
> Show View >
Other</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> and then select
+ </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">MBean
Explorer</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> and click </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">OK</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added">)</diffmk:wrapper></para></listitem>
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Click the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">New
Connection</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> icon
+
+ </diffmk:wrapper><inlinemediaobject
diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/new_connection_icon.png"></imagedata>
+ </imageobject>
+ </inlinemediaobject><diffmk:wrapper
diffmk:change="added">
+
+ in the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">MBean
Explorer</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> menu
+ bar.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">In the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Create JMX
Connection</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> dialog, hit </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Next</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> and then click the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Advanced</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> tab.
</diffmk:wrapper></para></listitem>
+
+
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">In the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JMX
URL</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> input field enter the following
URL:</diffmk:wrapper></para>
+
+ <programlisting diffmk:change="added"
format="linespecific" role="XML"><diffmk:wrapper
diffmk:change="added"><![CDATA[
+ service:jmx:rmi:///jndi/rmi://:9999/jmxrmi
+ ]]></diffmk:wrapper></programlisting>
+
+ <figure diffmk:change="added"
float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">JMX Connection</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/mbeans.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Press </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> to esteblish the connection with the
application.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Now expand the connection you have just created, then
open the </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">com.example</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> package and click </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">sayHello()</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> method. </diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Once the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">sayHello()</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> method is clicked the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">MBean
Editor</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> is activated. </diffmk:wrapper></para>
+
+ </listitem>
+
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">In the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">MBean
Editor</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> go to the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Operation
Details</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> section and hit the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">sayHello()</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> button.</diffmk:wrapper></para><para
diffmk:change="added"><diffmk:wrapper diffmk:change="added">
You will get the "Operation inoked successfully" message.
</diffmk:wrapper></para>
+
+ <figure diffmk:change="added"
float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Ivoking Method via
JMX</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/invokemethod.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The final step is to make sure the application worked
as it was expected. Open the terminal where you launched the application in step 3. Now
you see the "hello, world" message on the screen.
</diffmk:wrapper></para>
+ </listitem>
+</orderedlist>
+
+
+
+ </section>
<section>
<title>Tomcat Managing</title>
@@ -205,42 +328,42 @@
property <emphasis>
<property
moreinfo="none">com.sun.management.jmxremote.ssl</property>
</emphasis> is set to false. </para>
- <para>More information to manage Tomcat can be found in Tomcat management
- documentation.</para>
- <para>Instructions to manage remotely Tomcat are available in Tomcat's
monitoring
- documentation.</para>
+ <para><diffmk:wrapper diffmk:change="added">More
information to manage Tomcat can be found in </diffmk:wrapper><ulink
diffmk:change="added"
url="http://tomcat.apache.org/tomcat-6.0-doc/"><diffmk:wr...
diffmk:change="added">Tomcat management
documentation</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+ <para><diffmk:wrapper diffmk:change="added">Instructions to
manage remotely Tomcat are available in </diffmk:wrapper><ulink
diffmk:change="added"
url="http://tomcat.apache.org/tomcat-6.0-doc/monitoring.html"&g...
diffmk:change="added">Tomcat's monitoring
documentation</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+
</section>
<section>
<title>Eclipse Equinox Managing</title>
<para>You can manage Equinox through the Equinox monitoring
framework.</para>
- <para>Once you have installed the Equinox monitoring framework and
restarted Eclipse:</para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">In this section we will show you how to connect to an
Equinox server via JBoss JMX tools. First off, you need to make for example a simple
servlet and run it on a server. This guide is not intended to teach you how to build
application and run them on the server, you can read for example
</diffmk:wrapper><ulink diffmk:change="added"
url="http://www.eclipse.org/equinox-portal/tutorials/server-side/&qu...
diffmk:change="added"> this tutorial
</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> to get a better idea of how to build server-based
applications with Eclipse Equinox. </diffmk:wrapper></para>
+ <para><diffmk:wrapper diffmk:change="changed">Once you have run an
application on the server you can connect to it using JBoss JMX
tools.</diffmk:wrapper></para>
- <itemizedlist>
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
<listitem>
<para>Go to <emphasis>
<property moreinfo="none">Window > Open
Perspective > Other</property>
- </emphasis> and select the <property
moreinfo="none">JMX perspective</property></para>
+ </emphasis> and select the <property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JMX
perspective.</diffmk:wrapper></property></para>
</listitem>
- <listitem>
+ <!--<listitem>
<para>Select <emphasis>
- <property moreinfo="none">JMX Server > Open
Connection</property>
- </emphasis> and click on <emphasis>
- <property moreinfo="none">OK</property>
+ <property>JMX Server > Open Connection</property>
+ </emphasis> and click <emphasis>
+ <property>OK</property>
</emphasis></para>
- </listitem>
+ </listitem>-->
<listitem>
<para>Switch to the <property moreinfo="none">MBean
Explorer</property> by going to <emphasis>
<property moreinfo="none">Window > Show View
> Other</property>
- </emphasis> and selecting the MBean Explorer</para>
+ </emphasis><diffmk:wrapper diffmk:change="changed">
and selecting the MBean Explorer.</diffmk:wrapper></para>
</listitem>
<listitem>
- <para>Click on the <emphasis>
+ <para><diffmk:wrapper diffmk:change="changed">Click
the </diffmk:wrapper><emphasis>
<property moreinfo="none">New
Connection</property></emphasis> icon
<inlinemediaobject>
@@ -249,24 +372,34 @@
</imageobject>
</inlinemediaobject>
- in the <property moreinfo="none">MBean
Explorer</property> menu
- bar </para>
+ in the <property moreinfo="none">MBean
Explorer</property><diffmk:wrapper diffmk:change="changed"> menu
+ bar.</diffmk:wrapper></para>
</listitem>
<listitem>
<para>Select the <emphasis>
<property moreinfo="none">Advanced
tab</property></emphasis> and set the JMX URL to <emphasis>
- <property
moreinfo="none">service:jmx:rmi:///jndi/rmi://:8118/jmxserver</property>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">service:jmx:rmi:///jndi/rmi://:8118/jmxserver.</diffmk:wrapper></property>
</emphasis></para>
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Using JMX Tools to Access Equinox
Server</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/equinox.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
</listitem>
- </itemizedlist>
+ </orderedlist>
<para>You now have access to the MBeans exposed by Equinox.</para>
</section>
- <section>
- <title>Managing JBoss Instances</title>
+ <section>
+ <title><diffmk:wrapper diffmk:change="changed">Managing
JBoss AS</diffmk:wrapper></title>
<para>Managing JBoss instances is not supported with the <property
moreinfo="none">JMX Tools</property>
alone. You must also download and install the <property
moreinfo="none">AS Tools</property> portion of
@@ -274,46 +407,92 @@
tooling, you cannot create a JBoss JMX connection yourself or through the
Connection
Wizard. The first step is to create a JBoss Server. The full instructions for
this can
be found in the AS Tools section, however, the short summary is:
</para>
- <itemizedlist>
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
<listitem>
- <para>Open the <property
moreinfo="none">Servers</property> view</para>
+ <para>Open the <property
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Servers</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> view.</diffmk:wrapper></para>
</listitem>
<listitem>
<para>Right-click in the view and select <emphasis>
<property moreinfo="none">New >
Server</property>
- </emphasis></para>
+ </emphasis><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
</listitem>
<listitem>
<para>In the <emphasis>
- <property moreinfo="none">JBoss
Community</property>
- </emphasis> section, select a server version</para>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss Enterprise
Middleware</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
or in </diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none">JBoss Community</property>
+ </emphasis><diffmk:wrapper diffmk:change="changed">
section, select a server version.</diffmk:wrapper></para>
</listitem>
<listitem>
- <para>If a runtime has not yet been created, you'll be prompted
for the
- server's home directory, JDK, and configuration</para>
+ <para><diffmk:wrapper diffmk:change="changed">If a
runtime has not yet been created, you'll be prompted for the
+ server's home directory, JDK, and
configuration.</diffmk:wrapper></para>
</listitem>
<listitem>
<para>Finish the wizard and note that you have a new entry in both
the
- <property moreinfo="none">Servers</property>
view and the <property moreinfo="none">MBean
- Explorer</property></para>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Servers</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed"> view and the </diffmk:wrapper><property
moreinfo="none">MBean
+ Explorer</property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
</listitem>
<listitem>
<para>Start the server by right-clicking it and selecting
<emphasis>
- <property
moreinfo="none">Start</property></emphasis></para>
+ <property
moreinfo="none">Start</property></emphasis><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
</listitem>
<listitem>
- <para>Note that once the server is started, the JMX connection can
be
- expanded</para>
+ <para><diffmk:wrapper diffmk:change="changed">Note
that once the server is started, the JMX connection can be
+ expanded.</diffmk:wrapper></para>
</listitem>
- </itemizedlist>
+ </orderedlist>
<para>Now you can explore MBeans exposed by a JBoss instance.</para>
</section>
+
+ <section diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Managing JBoss AS
Remotely</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">JBoss JMX Tool allow you to easily get access and
mangane JBoss AS server remotely.
+ In order to get connected to the instance of JBoss AS remotely you need to run the
server or make sure the server is lauched.
+ </diffmk:wrapper></para>
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Go to </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Window
> Open Perspective > Other</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
and select the </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JMX
perspective.</diffmk:wrapper></property></para>
+ </listitem>
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Switch to the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">MBean
Explorer</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> by going to </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Window
> Show View > Other</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added">
and selecting the MBean Explorer.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Click the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">New
Connection</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> icon
+
+ </diffmk:wrapper><inlinemediaobject
diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/new_connection_icon.png"></imagedata>
+ </imageobject>
+ </inlinemediaobject><diffmk:wrapper
diffmk:change="added">
+
+ in the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">MBean
Explorer</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> menu
+ bar.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Select the </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Advanced
tab</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> and set the JMX URL
to: </diffmk:wrapper></para>
+ <programlisting diffmk:change="added" format="linespecific"
role="XML"><diffmk:wrapper diffmk:change="added"><![CDATA[
+service:jmx:rmi://localhost/jndi/rmi://localhost:1090/jmxconnector
+ ]]></diffmk:wrapper></programlisting>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Please, note that in this example we connected to the
local host. </diffmk:wrapper></para>
+ </listitem>
+ </orderedlist>
+ </section>
<section id="extensions" xreflabel="extensions">
<title>Extension Task</title>
<para>This section will outline how to contribute your own Server type with
some default
@@ -358,9 +537,8 @@
<listitem>
<para>org.jboss.tools.jmx.ui.attribute.controls - allows you to
map class types to some
Control to present them in the MBean Editor</para>
- <para>We hope, this guide helped you to get started with the
JBoss JMX Tools.
- Besides, for additional information you are welcome on
- <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...
forum</ulink>.</para>
+ <para>We hope, this guide helped you to get started with the
JBoss JMX Tools. Besides, for additional information you are welcome on <ulink
+
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...
forum</ulink>.</para>
</listitem>
</itemizedlist>
</section>
@@ -385,12 +563,12 @@
this server is in the connected state only when the server is started.
</para>
- <section><title>The Default Connection</title>
+ <section><title><diffmk:wrapper
diffmk:change="changed">Establishing
Connection</diffmk:wrapper></title>
<para> There are two ways to connect to an application with remote
management enabled:</para>
- <para> The first step is the same for both - to connect to a MBean
Server, click on the
- <emphasis>
+ <para><diffmk:wrapper diffmk:change="changed"> The
first step is the same for both - to connect to a MBean Server, click the
+ </diffmk:wrapper><emphasis>
<property moreinfo="none">New
Connection</property></emphasis> icon
<inlinemediaobject>
@@ -404,14 +582,16 @@
<para>Then to follow the simple one you just need to specify host, port
(and optionally user
name and password) and click <emphasis>
<property
moreinfo="none">OK</property>.</emphasis></para>
+ <para><diffmk:wrapper diffmk:change="added">On the
</diffmk:wrapper><property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Advanced</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> tab you can set the sever name (it will be displayed
in </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">MBean
Explorer</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">), a url to the remote server.
+ For example, to connect to JBoss AS you need to set the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JMX
URL</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> to
+ </diffmk:wrapper></para>
+ <programlisting diffmk:change="added"
format="linespecific" role="XML"><diffmk:wrapper
diffmk:change="added"><![CDATA[
+service:jmx:rmi://localhost/jndi/rmi://localhost:1090/jmxconnector
+ ]]></diffmk:wrapper></programlisting>
+ <para><diffmk:wrapper diffmk:change="changed">If it is required
you can enter user name and password for the server connection.
+ </diffmk:wrapper></para>
+
- <para>The default JMX URL is <emphasis>
- <property
moreinfo="none">service:jmx:rmi:///jndi/rmi://localhost:3000/jmxrmi</property>.</emphasis></para>
-
- <para>In case you need to connect to an application which has not used
the "standard" JMX URL
- (e.g. Eclipse Equinox), you need chose more advance way, where it's
necessary to specify
- explicitly a JMX URL in the Advanced tab of the JMX Connection
window.</para>
-
<note>
<title>Note</title>
<para>Only JMX URL based on RMI are supported.</para>
@@ -422,7 +602,7 @@
-<chapter id="references"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jmx/docs/reference/en/modules/references.xml"
xreflabel="references">
+<chapter id="references"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jmx/docs/reference/en-US/references.xml"
xreflabel="references">
<?dbhtml filename="references.html"?>
<title>References</title>
@@ -548,16 +728,16 @@
</imageobject>
</mediaobject>
</figure>
- <figure diffmk:change="added" float="0"
id="figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor">
- <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Visual Page Editor</diffmk:wrapper></title>
- <mediaobject diffmk:change="added">
- <imageobject diffmk:change="added">
- <imagedata diffmk:change="added"
fileref="images/mbean-editor-horizontal-layout_0.2.0.png" format="PNG"
width="444"></imagedata>
+ <figure float="0"
id="figu-Beginners_Guide-Visual_Web_Tools-Visual_Page_Editor">
+ <title>Visual Page Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/mbean-editor-horizontal-layout_0.2.0.png" format="PNG"
width="444"></imagedata>
</imageobject>
- <textobject diffmk:change="added">
- <phrase diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+ <textobject>
+ <phrase>
The Visual Page Editor, showing both the source and a visual
preview simultaneously.
- </diffmk:wrapper></phrase>
+ </phrase>
</textobject>
</mediaobject>
</figure>
@@ -593,7 +773,7 @@
</chapter>
-<chapter
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jmx/docs/reference/en/modules/summary.xml">
+<chapter
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/jmx/docs/reference/en-US/summary.xml">
<?dbhtml filename="summary.html"?>
<title>Summary</title>
<para>In conclusion, with this document you could easily start with JXM Tools.