Products | Versions |
---|---|
TIBCO MDM | - |
Not Applicable | - |
Introduction.
The standard jconsole.exe and jvisualvm.exe provided in the Java JDK bin directory do not work with JBoss. Instead, the JBOSS_HOME/bin/jconsole(.bat or .sh) and JBOSS_HOME/bin/jvisualvm.sh script files provided out of the box with JBoss AS 7.1.1.Final needs to be used. This KB Article explains how to correctly set up JMX connectivity for MDM 8.3.x running on JBOSS AS7.1.1.Final for both Local and Remote JMX Access.
Starting up Jconsole / Jvisualvm Locally on a Server where JBoss is present.
If running jconsole and jvisualvm locally, the following script files need to be used :Starting up Jconsole / Jvisualvm Remote to a Server where JBoss is present (that is, no JBoss on the local machine).
To run jconsole or jvisualvm on a remote machine, if that remote machine does not have JBoss installed, certain JBoss module JAR files (files under JBOSS_HOME/module), as well as jconsole.sh/jvisualvm.sh / jconsole.bat/jvisualvm.bat, need to be copied, preserving the module directory structure.Required JBOSS Libraries
The required JBoss module JAR files (for connecting to a JBoss AS 7.1.1.final server), together with the jconsole.bat and jvisualvm.bat Windows batch files and jconsole.sh and jvisualvm.sh Linux script files, have been zipped up into a single zip file and attached to this KB Article (Filename: jboss_jmx.zip). It is ready to deploy to a remote workstation.Connecting to the JBoss MDM server with Jconsole once Jconsole is Started.
Whether running locally or remotely, when the relevant connection window appears, enter the following into the Remote Process box:where <jboss_server> is the either the IP or hostname of the Jboss server, and then provide a valid AdministrationRealm Username and Password. Having provided these details, select Connect. A pop-up window will appear and jconsole
will connect. If the connect fails, exit and restart
jconsole.bat and repeat the connect process. Do so up to four times to make sure any old connection details that may be causing issues are cleared.
Connecting to the JBoss MDM server with Jvisualvm once Jvisualvm is Started
Whether running locally or remotely, when the relevant connection window appears, right mouse-click on "Remote" and select "Add remote host". Type in a suitable host name or IP - jvisualvm will then search for the host. If found, it will add the host to the Remote list. Right click on the newly added host and select "Add JMX Connection...". In the connection box, replace the host details with:Notes on 1.Credentials;2.Ports;3.Port Offsets;4.Ensuring the Management Interface is Open for Remote Access;5.jboss-modules.jar .
$JBOSS_HOME/bin/add-user.sh (Linux)
%JBOSS_HOME%\bin\add-user.bat (Windows)
on the MDM server. By convention, 'admin' is the normal username to use.
If jboss.management.native.port is set to a value other than 9999 or jboss.socket.binding.port-offset is set to a value other than 0, the correct port or port+offset number needs to be used instead: new values for jboss.management.native.port and jboss.socket.binding.port-offset can be provided using the JVM -D parameter mechanism. The default values after the colon in standalone.xml are only used where -D values are not specified. This point is important if it is found that it is not possible to connect to the JMX console using 9999 when it otherwise should be. In this case, in addition to checking the "colon" default values in JBOSS_HOME/standalone/configuration/standalone.xml, it is also advisable to check JBOSS_HOME/bin/standalone.conf(.bat) and JBOSS_HOME/bin/standalone (.sh or .bat), to see if -Djboss.management.native.port=... and/or -Djboss.socket.binding.port-offset=... have been used.
to "open up" the management port (9999) to remote clients. If it proves to be necessary to add the management bind address parameter, it is also required that the JBoss MDM server be restarted before any connections using Jconsole, Jvisualvm or other JMX-based tool are attempted.
Note 5: If not already there, the jar file jboss-modules.jar (available from the JBoss download site) needs to be placed in the JBOSS_HOME directory.