Activating the XU MBean in Java SE

In Java™ SE, you must activate the XU MBean to retrieve execution statistics and notify ruleset updates.

About this task

The Rule Execution Server console uses the XU MBean plug-in to compute execution statistics and to notify 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 add and edit a ra.xml file.

Add a ra.xml file to the classpath of the application (WEB-INF/classes for a web application) to change the default behavior of the XU in Java SE.
Edit the ra.xml file (WEB-INF/classes/ra.xml) to modify the value of the plugins property.

Important:

The ra.xml file is delivered with the product in <InstallDir>/executionserver/bin/ra.xml, where InstallDir is the directory where you installed the product.
Do not modify the default_ra.xml file. The ra.xml file in the classpath overrides the default_ra.xml file when you use 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.

Procedure

To activate the XU MBean in Java SE:

Add 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 to make sure that the modification has been registered.