Activating the XU MBean in Java SE

To retrieve execution statistics and notify the execution unit (XU) of ruleset updates in Java™ SE, you must activate the XU MBean.

About this task

The Rule Execution Server console uses the execution unit (XU) MBean plug-in to compute execution statistics and to notify execution units of updates on rulesets. In Java SE, the XU MBean is not declared by default. For the management stack to find the XU MBean in Java SE, you must activate the XU MBean by declaring it in a ra.xml file.

The ra.xml file is delivered with the product in the <InstallDir>/executionserver/bin directory, where InstallDir is the directory where you installed the product.

Attention: DO NOT modify the default ra.xml file. The ra.xml file in the class path overrides the default ra.xml file when you use the XU in Java SE.

Procedure

Add a ra.xml file to the class path of the application to change the default behavior of the XU in Java SE.
You must use the same data source for the management stack and the execution stack. In the classes directory of your web application, you must add the ra.xml file where jdbc is the default value of the persistencyType property. By default, the Java SE provider does not use a data source.

For a web application, the class path is WEB-INF/classes.

Edit the ra.xml file to modify the value of the plugins property by adding the following lines to the XU deployment descriptor.

<config-property>
   <config-property-name>plugins</config-property-name>
   <config-property-type>java.lang.String</config-property-type>
   <config-property-value>
      {pluginClass=ilog.rules.res.xu.management.IlrManagementMBeanPlugin, xuName=default},
      {pluginClass=com.ibm.rules.dvs.plugin.IlrExecutionTracePlugin}
   </config-property-value>
</config-property>

Restart the application server.