easy-rules/site/user-guide/managing-rules.md

layout	title	header	prev_section	next_section	doc
docs	Managing rules	Managing rules at runtime	user-guide/rules-engine	tutorials/hello-world	true

Being able to dynamically reconfigure business rules at runtime in production systems is a recurrent requirement.

Thanks to JMX, Easy Rules can expose rules attributes to be managed via any JMX compliant client.

To make your rule manageable via JMX, first you need to add the following dependency to your pom.xml:

<dependencies>
    <dependency>
        <groupId>org.easyrules</groupId>
        <artifactId>easyrules-jmx</artifactId>
        <version>{{site.version}}</version>
    </dependency>
</dependencies>

Then, you can register it in Easy Rules engine as a JMX managed rule:

JMXRulesEngine rulesEngine = new DefaultJMXRulesEngine();
rulesEngine.registerJmxRule(myRule);

This will register your rule as a JMX managed bean with the following object name:

org.easyrules.core.jmx:type=YourRuleClassName,name=YourRuleName

By default, rule description and priority are exposed as JMX manageable attributes. If you need to expose more specific attributes, you can extend the JMXRule interface and add getters and setters of your manageable attributes.

An example of using dynamic rule reconfiguration at runtime is provided in the online shop tutorial.