Jetty has moved!
Jetty is a project at the Eclipse Foundation.
Homepage:http://www.eclipse.org/jetty
Downloads: http://download.eclipse.org/jetty/
Documentation:http://www.eclipse.org/jetty/documentation/current/
About:http://www.eclipse.org/jetty/about.php
Jetty Powered:http://www.eclipse.org/jetty/powered/
Contact the core Jetty developers at www.webtide.com
private support for your internal/customer projects ... custom extensions and distributions ... versioned snapshots for indefinite support ... scalability guidance for your apps and Ajax/Comet projects ... development services from 1 day to full product delivery
Skip to end of metadata
Go to start of metadata

Jetty JMX Integration

The jetty JMX integration is based on the ObjectMBean implementation of DynamicMBean. This implementation allows an arbitrary POJO to be wrapped in an MBean and for meta data to be provided by properties files

The creation of MBeans is coordinated by the MBeanContainer implementation of the Container.Listener interface. The Jetty Server and it's components use a Container to maintain a containment tree of components and to support notification of changes to that tree. The MBeanContainer class listens for Container events and creates and destroys MBeans as required to wrap all Jetty components.

Using Jetty MBeans

The simplest way to use Jetty MBeans is to use the JVM supplied jconsole utility. If you use mx4j, then an internal HTTP agent can also be used (see jetty-jmx.xml config file comments).

See Running jetty with jconsole for instructions on how to configure jmx for use with Sun's jconsole.

Jetty Standalone

The MBeanContainer instance can be configured for a Jetty server by the jetty-jmx.xml configuration file. This can be run with the standard configuration file as follows:

Icon

Jetty 7 requires -DOPTIONS=jmx to be used when starting up Jetty. That is, instead of the above, use this:
java -DOPTIONS=jmx -jar start.jar etc/jetty-jmx.xml etc/jetty.xml

Jetty Maven Plugin

If you are using the jetty maven plugin you should copy the etc/jetty-jmx.xml file into your webapp project somewhere, such as src/etc, then add a <jettyConfig> element to the plugin <configuration>:


If you are using mx4j with the jetty-plugin then you should add the mx4j-tools dependecy to the jetty plug-in declaration. It goes something like:



Running on Java 1.4 and below (with MX4J)

To run on Java 1.4 and below, mx4j library is used to provide the MBean server.
The commented out section of jetty-jmx.xml needs to be added to create the
mbean server and to register the JMX RMI connector:

Then, you will need to ensure that you have the rmiregistry running. The start sequence becomes:

You then need to configure jconsole to find this remote connector using the Advanced panel and enter the connector url like so:

Click the Connect button and you will be able to manipulate the Jetty mbeans.

  • No labels

1 Comment

  1. An example of how to start up Jetty with JMX programatically:

    public static void main(String[] args) throws Exception {
    
        Server server = new Server();
        SelectChannelConnector connector = new SelectChannelConnector();
        connector.setPort(8080);
        server.addConnector(connector);
    
        WebAppContext web = new WebAppContext();
        web.setContextPath("/wicket-in-action");
        web.setWar("src/webapp");
        server.addHandler(web);
    
        MBeanServer mBeanServer = ManagementFactory.getPlatformMBeanServer();
        MBeanContainer mBeanContainer = new MBeanContainer(mBeanServer);
        server.getContainer().addEventListener(mBeanContainer);
        mBeanContainer.start();
    
        try {
          server.start();
          server.join();
        } catch (Exception e) {
          e.printStackTrace();
          System.exit(100);
        }
      }
    
Contact the core Jetty developers at www.webtide.com
private support for your internal/customer projects ... custom extensions and distributions ... versioned snapshots for indefinite support ... scalability guidance for your apps and Ajax/Comet projects ... development services from 1 day to full product delivery