jmx:server

Description

A job which allows client a local job hierarchy to be monitored and managed remotely via JMX.

Security can be added using the environment property. Simple JMX security comes prepackaged as jmx:server-security.

For more information on JMX Security see The JMX Tutorial.

Please note that the none namespaced version of this element is deprecated and will be removed in the next version.

Properties

Name	Description	Required
name	A name, can be any text.	No.
root	The root node.	Yes.
url	The JMX service URL.	Yes.
logFormat	The log format for formatting log messages. For more information on the format please see http://logging.apache.org/log4j/docs/	No.
handlerFactories	Additional handler factories that allow any interface to be invoked from a remote Oddjob.	No.
environment	An environment such as security settings.	No.

Example

Typical configuration is:

 <jmx:server xmlns:jmx="http://rgordon.co.uk/oddjob/jmx"
            name="My Server" 
            url="service:jmx:rmi://ignored/jndi/rmi://localhost/my-oddjob" 
            root="${some-job}"/>

Create a secure server:

 <jmx:server xmlns:jmx="http://rgordon.co.uk/oddjob/jmx"
          root="${some-job}" 
          url="service:jmx:rmi://ignored/jndi/rmi://localhost/my-oddjob" >
  <environment>
   <jmx:server-security>
    <passwordFile>
     <file file="C:\rob\java\jmx_examples\Security\simple\config\password.properties"/>
    </passwordFile>
   </jmx:server-security>
  </environment>
 </jmx:server>