# JmxWeb Plugin Readme

JmxWeb plugin is web based platform for managing and monitoring openfire via JMX. It includes hawtio, a lightweight and modular HTML5 web console with lots of plugins and jolokia a JMX-HTTP bridge providing a web based alternative to JSR-160 connectors. It also includes the mbeans from the java-monitor probe for openfire.

## Prerequesites

## Installation

1. Stop Openfire.
2. Copy the jmxweb.jar file to the OPENFIRE_HOME/plugins directory.
3. Restart Openfire.

## Configuration

If you want to monitor openfire JMX mbeans, enable JMX by adding the following to System Properties via the Web Admin Console or add into the table ofproperty.

- xmpp.jmx.enabled (true or false)
- xmpp.jmx.secure (true or false)

If you want your admin users to recieve periodic summary emails of JMX, configure Opefire email service and add the following to System Properties via the Web Admin Console.

- jmxweb.email.monitoring - (true or false)
- jmxweb.crontrigger.schedule - (a cron-trigger expression. The default setting is "0 0 0/12 * * ?" which means run report daily, twice a day at 12 midnight and 12 noon.)
- jmxweb.admin.username - any valid admin user name. Required if >xmpp.jmx.secure is set to true
- jmxweb.admin.password - the password for above admin user. Required if >xmpp.jmx.secure is set to true

## How to use

To access hawtio, point your browser at http://your-server:7070/hawtio

To access jolokia rest api from your javascript applications use URL http://your-server:7070/jolokia . Make sure you provide headers for basic authentication.