Skip navigation FileNet logo
Glossary  |  Help Directory  
  Help for Rules Engine Administration
  Search  |  Index
Process Reference  
Rules Engine Administration
Installing and enabling
Rules repository
Transferring workflows
Workflow and repository versions
Starting Rules Builder
Creating and exporting rules
Reinitializing regions
Troubleshooting
   

Troubleshooting Rules Engine

Running workflows that use rules stop or encounter an exception.

A running workflow that uses rules may fail to execute for several reasons; the Rules Engine may be stopped or the .ilr file for the workflow may be missing.

  • Rules Engine is stopped.
    If the Rules Engine is stopped when a workflow tries to run a rule, the Process Engine will try to execute the rule again. The Process Engine will continue to retry to execute the rule until the Rules Engine is started again. The Process Engine will also write an error to the Event Viewer (Windows) or system log (UNIX) each time it attempts to run a rule. Note that system performance will deteriorate as more and more workflows attempt to run rules.

  • .ILR file for the workflow is missing.
    If the .ilr file for the workflow is missing, Process Engine enters an exception in the Conductor queue similar to the following:

    Couldn't find <filename>.ilr file

    Verify that the .ilr file exists and create it if necessary. See Creating and exporting rules for information.

Workflows run without executing any rules.

If the Rules Engine is disabled in the Process Configuration Console, any workflows that use rules will run without exception but will not execute the rules. See Installing, enabling, and starting the Rules Engine for information on enabling the Rules Engine integration.

Workflow repository is missing or not created after transferring the workflow definition from Process Designer.

If the Rules Engine is stopped when you transfer a workflow definition, Rules Engine cannot create a workflow repository. Start the Rules Engine and transfer the workflow definition again.

NOTE The first time you transfer a workflow definition from the Process Designer, Rules Engine creates a workflow repository under the Repositories folder. On Windows systems, this folder is located under fnsw_loc\connectors\ILOG\repositories\<isolated region number>\<workflow name>\; on UNIX systems, this folder is located under fnsw/local/connectors/ILOG/repositories/<isolated region number>/<workflow name>/. Thereafter, a new version of the workflow repository is created only if the user adds or deletes data fields or maps, or adds rule sets.