JBoss Community Archive (Read Only)

RHQ 4.7

JMX - Server

JMX - Server

Overview

Internal Name:

JMX Server

Description:

Generic JMX Server

Singleton:

no

Plugin:

JMX

Managed Resource Configuration

In order to monitor your Java applications via JMX, you need to expose their MBeans to remote JMX clients.
In order to do this, you must pass in some system properties when starting your application's Java virtual
machine.

To run a JVM with JMX remoting enabled without authentication, you must pass in the following system
properties:

  • -Dcom.sun.management.jmxremote.port=19988

  • -Dcom.sun.management.jmxremote.ssl=false

  • -Dcom.sun.management.jmxremote.authenticate=false

You can require your remote JMX endpoint to demand authentication for clients to be able to connect to it.
To run a JVM with JMX remoting enabled with password authentication:

  • -Dcom.sun.management.jmxremote.port=19988

  • -Dcom.sun.management.jmxremote.ssl=false

  • -Dcom.sun.management.jmxremote.authenticate=true

  • -Dcom.sun.management.jmxremote.password.file=/some/directory/jmxremote.password

Note that "jmxremote.password" must be read-only. On Windows, you must use "cacls" command to do this:

cacls /some/directory/jmxremote.password /P username:R

A password file template is located at $JRE_HOME/lib/management/jmxremote.password.template. There is also
an auth file that you can use to define other roles. For more information on setting this up and setting up
SSL, see Monitoring and Management Using JMX.

If you wish to expose your JBossAS 4 application server's MBeans over this remote JMX mechanism, you must
pass in these extra properties, in addition to the properties specified above:

  • -Djboss.platform.mbeanserver

  • -Djavax.management.builder.initial=org.jboss.system.server.jmx.MBeanServerBuilderImpl

Autodiscovery Process Scans

Name

Query

java

process|basename|match=^java.*

Connection Settings

Name

Description

Required

Internal Name

Type

The EMS connection type for this JMX Server

yes

type

Connector Address

The connection url in the form of a JMXServiceURL - this should only be set if the JVM has JMX Remoting enabled

no

connectorAddress

Install URI

The installation path for the selected server type which will be used to find client libraries (if appropriate)

no

installURI

Principal

The login principal/username

no

principal

Credentials

The login credentials/password

no

credentials

Additional Class Path Entries

Comma-separated list of directories and filenames that contain resources and classes needed to communicate with the JMX Server and its MBeans. If you specify 'some/directory/*.jar', all jars found in the given directory will be added.

no

additionalClassPathEntries

Command Line

the command line of the JVM at the time it was discovered - only used by JVMs with type Local; if the command line of the JVM changes, this property's value will need to be updated accordingly in order for RHQ to connect to the JVM

no

commandLine

You must use the internal name to reference properties in Dynamic Group Definition expressions.

JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-12 14:16:02 UTC, last content change 2012-05-09 14:48:39 UTC.