From jbosstools-commits at lists.jboss.org Thu Jan 8 14:40:27 2009 Content-Type: multipart/mixed; boundary="===============5427020629190376479==" MIME-Version: 1.0 From: jbosstools-commits at lists.jboss.org To: jbosstools-commits at lists.jboss.org Subject: [jbosstools-commits] JBoss Tools SVN: r12939 - trunk/jmx/docs/reference/en/modules. Date: Thu, 08 Jan 2009 14:40:27 -0500 Message-ID: --===============5427020629190376479== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Author: smukhina Date: 2009-01-08 14:40:27 -0500 (Thu, 08 Jan 2009) New Revision: 12939 Modified: trunk/jmx/docs/reference/en/modules/introduction.xml Log: JBDS-528 error in syntax is fixed. new info is added from wiki plugin page = Modified: trunk/jmx/docs/reference/en/modules/introduction.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --- trunk/jmx/docs/reference/en/modules/introduction.xml 2009-01-08 17:14:0= 8 UTC (rev 12938) +++ trunk/jmx/docs/reference/en/modules/introduction.xml 2009-01-08 19:40:2= 7 UTC (rev 12939) @@ -1,60 +1,152 @@ - - - = + + + Introduction = - This chapter covers the basics of working with JMX plugin, which i= s used to manage Java applications through JMX and its RMI Connector. - - To start using it, it's necessary to open JMX perspective. Go to W= indow > Open Perspective > Other... and then select JMX and click OK + This chapter covers the basics of working with JMX plugin, which i= s used to manage Java + applications through JMX and its RMI Connector. = - The JMX perspective is composed of a single view - MBean Explorer = which lists the mbeans. When you double-click on a MBean in the MBean Explo= rer view, it opens a multi-page editor to manage the MBean. The MBeanEdito= r is composed of 3 pages: +
+ Installation + = + eclipse-jmx can be installed either by using Eclipse update manag= er or by downloading it and installing it manually in Eclipse. + = + Tip + Check Requirements to see what is required to install and use ec= lipse-jmx. + = +
Manual Installation + Follow the next steps to install the plugin manually: + = + = + Download the latest release from http://code.google.co= m/p/eclipse-jmx/downloads/list + Unzip the file in you Eclipse installation + (Re)Start Eclipse + = +
+ = +
Installation using Eclipes update manager + = + In Eclipse: + = + = + go to Help > Software Updates > Find and Install...= + check Search for new features to install and click Next = + click on New Remote Site... + in the New Update Site window, type: + Name: eclipse-jmx + URL: http://eclipse-jmx.googlecode.com/svn/trunk/net= .jmesnil.jmx.update/ + click on OK + check eclipse-jmx and click on Finish + expand the features and select the latest one. Then = click on Next + check I accept the terms in the license agreement an= d click on Next + click on Finish + once all the plug-ins are downloaded, click on Insta= ll All + finally, when ask to restart Eclipse, click on Yes + +
= + = +
= - - Attributes to get/set the attributes of the MBean - Operations to invoke operations on the MBean - Notifications to receive notifications from the MBean<= /para> - Info which displays general information about the MBea= n - = -There is a button to update the MBean attribute value (if it is writ= able) - = + To start using it, it's necessary to open JMX perspective. Go to W= indow > Open Perspective > + Other... and then select JMX and click OK + + The JMX perspective is composed of a single view - MBean Explorer = which lists the mbeans. + When you double-click on a MBean in the MBean Explorer view, it opens = a multi-page editor to + manage the MBean. The MBeanEditor is composed of these pages: + + + + Attributes to get/set the attributes of the MBean + + + Operations to invoke operations on the MBean + + + Notifications to receive notifications from the MBean + + + Info which displays general information about the MBean + + + + There is a button to update the MBean attribute value (if it is wr= itable) + +
+ Requirements + Requirements to use eclipse-jmx are the following: + + + + eclipse-jmx is developed on Eclipse 3.3 milestones. It is a= lso tested on latest + stable 3.2 release. + + + eclipse-jmx 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) + + +
+ +
+ How to Manage Tomcat + It's possible to manage Tomcat using eclipse-jmx + Currently, eclipse-jmx is able to connect to Tomcat without au= thentication or with password-based authentication. + Using SSL for authentication is not supported: you need to make s= ure that the System property com.sun.management.jmxremote.ssl is set to fal= se. + + More information to manage Tomcat can be found in Tomcat managem= ent documentation + Instructions to manage remotely Tomcat are available in Tomcat's= monitoring documentation. + = +
+ =
- Connection + Connection There are two ways to connect to an application with remote man= agement enabled: - The first step is the same for both - to connect to a MBean Ser= ver - click on the Connect... icon () in the MBean Explorer menu bar, = - = - Then to follow the simple one you just need to specify host, por= t (and optionally user name & password) and click OK - The default JMX URL is service:jmx:rmi:///jndi/rmi://localhost= :3000/jmxrmi - = - In case you need to connect to an application which has not use= d the "standard" JMX URL (e.g. Eclipse Equinox), you need chose more advanc= e way, where it's necessary to specify explicitly a JMX URL in the Advance= d Tab of the JMX Connection window - = - = - Note - only JMX URL based on RMI are supported -
- = + The first step is the same for both - to connect to a MBean Ser= ver - click on the + Connect... icon () in the MBean Explorer menu bar, + Then to follow the simple one you just need to specify host, por= t (and optionally user + name & password) and click OK + The default JMX URL is service:jmx:rmi:///jndi/rmi://localhost:3= 000/jmxrmi + + In case you need to connect to an application which has not use= d 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 windo= w + + + Note + only JMX URL based on RMI are supported + + +
= MBean Explorer - The MBean explorer displays the MBean features (both attributes = and operations) in its hierarchy. Double-clicking on a feature will open a = MBean Editor, display the page corresponding to the feature type and select= the feature. - Since It's possible to have many MBean Editors opened at the sam= e time, the MBean Explorer has a Link With Editor checkbox to synchronize s= elections between the active MBean Editor and the MBean explorer(and vice = versa) - = + The MBean explorer displays the MBean features (both attributes = and operations) in its + hierarchy. Double-clicking on a feature will open a MBean Editor, di= splay the page + corresponding to the feature type and select the feature. + Since It's possible to have many MBean Editors opened at the sam= e time, the MBean Explorer + has a Link With Editor checkbox to synchronize selections between th= e active MBean Editor and + the MBean explorer(and vice versa) + - The MBean Explorer has also a filter text that can be used to fi= lter among all the MBeans the few ones, which interest you. - = - For example, if you are only interested by MBeans related to mem= ory, typing memo will show only the MBeans registered under an ObjectName, = which contains memo: - = - A Collapse All button on the MBean Explorer toolbar is used to c= ollapse all the MBeans and display only the domains. It is also possible to= double click on a node to expand/collapse it. - = + The MBean Explorer has also a filter text that can be used to fi= lter among all the MBeans + the few ones, which interest you. + + For example, if you are only interested by MBeans related to mem= ory, typing memo will show + only the MBeans registered under an ObjectName, which contains memo:= + + A Collapse All button on the MBean Explorer toolbar is used to c= ollapse all the MBeans and + display only the domains. It is also possible to double click on a n= ode to expand/collapse it. +
- = +
Open MBean Action - A Navigation action helps opening MBeans in a MBean Editor. This= action is available either through the menu Navigate > Open MBean... or us= ing the key shortcut Ctrl + Shift + M (⌘+ Shift + M on Mac OS X) + A Navigation action helps opening MBeans in a MBean Editor. This= action is available + either through the menu Navigate > Open MBean... or using the key sh= ortcut Ctrl + Shift + M + (⌘+ Shift + M on Mac OS X)
- = - = - - = + + \ No newline at end of file --===============5427020629190376479==--