IBM Support

Known issue: After upgrading to IBM Case Manager 5.3.3-IF001 or later, deployment of rules fails during solution deployment

Troubleshooting


Problem

After upgrading to IBM® Case Manager V5.3.3-IF001 or later, rule deployment fails when you deploy your case management solution.

Symptom

When you deploy your case management solution that contains rules, the deployment will fail, and you might see an error similar to the following logged:

[6/22/18 12:37:14:086 CST] 000001c5 api E com.ibm.casemgmt.api error FNRPA0624E The rules could not be deployed because of the following error: An exception occurred in the event handler.
Message was: FNRPE0029E: [RULE_DEPLOYMENT_RULE_DEFINITION]: For case type SOL_Type1, exception occurred while converting following rule definition(s): TableRule1
com.ibm.casemgmt.intgimpl.deploy.handlers.ContinuableStepException: FNRPA0624E The rules could not be deployed because of the following error: An exception occurred in the event handler.
Message was: FNRPE0029E: [RULE_DEPLOYMENT_RULE_DEFINITION]: For case type SOL_Type1, exception occurred while converting following rule definition(s): TableRule1
 at com.ibm.casemgmt.intgimpl.deploy.handlers.ContinuableStepException.createContinuableStepException(ContinuableStepException.java:35) 

Cause

IBM Case Manager 5.3.3 Interim Fix 001 or later releases updated the embedded IBM Operational Decision Manager SDK to  8.8.1.3-IF083.  The updated version introduces classloader issues which now require the ODMMessages.jar file to be placed into the application server classpath on IBM FileNet Content Platform Engine server where the Rules_Operation component runs.

Diagnosing The Problem

In the FileNet P8 CPE server log (p8_server_error.log), which is typically located in the application server profile directory (/[profile]/FileNet/[server]), it will have an error similar to the following:

2018-10-26T18:07:05.413 79224D69 EVNT FNRCE0000E - ERROR Rule deployment failed. Rule app name: [Name] case type name: [CaseTypeName] Rule reference name: [RuleName]
java.util.MissingResourceException: Can't find com.ibm.rules.res.xu.messages bundle
        at java.util.logging.Logger.setupResourceInfo(Logger.java:1549)
        at java.util.logging.Logger.<init>(Logger.java:279)
        at java.util.logging.Logger.<init>(Logger.java:273)
        at com.ibm.rules.res.xu.log.internal.XULogger.<init>(XULogger.java:47)
        at com.ibm.rules.res.xu.log.internal.LogHandler.<init>(LogHandler.java:53)
        at ilog.rules.res.xu.spi.IlrManagedXUConnectionFactory.<init>(IlrManagedXUConnectionFactory.java:93)
        at com.ibm.rules.res.xu.client.internal.jca.ResourceAdapterFactory.createSPIFactory(ResourceAdapterFactory.java:44)
        at com.ibm.rules.res.xu.client.internal.jca.ResourceAdapterFactory.createCCIFactory(ResourceAdapterFactory.java:34)
        at com.ibm.rules.res.xu.client.internal.XUClient.createJ2SEXUClient(XUClient.java:74)
        at ilog.rules.res.session.IlrJ2SESessionFactory.createXUClient(IlrJ2SESessionFactory.java:167)
        at ilog.rules.res.session.IlrJ2SESessionFactory.getXUClient(IlrJ2SESessionFactory.java:368)
        at ilog.rules.res.session.IlrJ2SESessionFactory.createManagementSession(IlrJ2SESessionFactory.java:138)
        at ilog.rules.res.session.internal.IlrRuleServiceBase.getManagementSession(IlrRuleServiceBase.java:54)
        at ilog.rules.res.session.internal.IlrRuleServiceBase.getRepositoryFactory(IlrRuleServiceBase.java:62)
        at ilog.rules.res.session.internal.IlrRuleServiceBase.getRepository(IlrRuleServiceBase.java:70)
        at ilog.rules.res.session.IlrRuleService.isRulesetDeployed(IlrRuleService.java:152)
        at com.ibm.acm.rules.deployment.CaseRulesDeploymentUtility.deployRule(CaseRulesDeploymentUtility.java:272)
        at com.ibm.acm.rules.deployment.CaseRulesDeploymentUtility.buildAndDeployRule(CaseRulesDeploymentUtility.java:137)
        at com.ibm.casemgmt.intgimpl.eventhandler.ILogRuleDeploymentEventHandler.onEvent(ILogRuleDeploymentEventHandler.java:174)

Resolving The Problem

Complete the following steps to copy the required file on your system before you reattempt solution deployment:

  1. Copy the ODMMessages.jar file from the Case Manager install location (CaseManagement/configure/AddOns/ODMMessages.jar) to the following directory where Content Platform Engine is deployed:
    • WebSphere - <application server-home>/lib/ext.  Where <application server-home> is where WebSphere is installed, e.g. /IBM/WebSphere/AppServer/lib/ext.
    • Weblogic - <java-home>/lib/ext.  Where <java-home> is the JRE folder for the JDK that Weblogic is using, e.g. /opt/app/oracle/product/JAVA/jdk/jre/lib/ext.
  2. Restart the IBM FileNet Content Platform Engine applications server.

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSCTJ4","label":"IBM Case Manager"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
31 January 2019

UID

ibm10719975