SA-234

Summary

Trying to run BIX extraction on PRPC 5.4sp2 system from the command line and the extraction is failing to initialize the PegaRULES engine during startup.

Error Messages

Caused by: 
com.pega.pegarules.pub.clipboard.InvalidParameterException: Class not defined in dictionary: System-Work-Indexer.  Details: Invalid value for aClassName passed to PRThread.createPage
    at com.pega.pegarules.engine.context.base.ThreadPageDir.createPage(ThreadPageDir.java:178)
    at com.pega.pegarules.engine.context.base.ThreadPageDir.createPage(ThreadPageDir.java:107)
    at com.pega.pegarules.engine.context.PRThreadImpl.createPage(PRThreadImpl.java:607)
    at com.pega.pegarules.engine.database.DatabaseImpl.noteChange(DatabaseImpl.java:2634)
    at com.pega.pegarules.engine.database.DatabaseImpl.notifyOtherSystemsAfterUpdates(DatabaseImpl.java:1991)
    at com.pega.pegarules.engine.database.DatabaseImpl.attemptToProcessUpdates(DatabaseImpl.java:1656)
    at com.pega.pegarules.engine.database.DatabaseImpl.processUpdates(DatabaseImpl.java:1504)
    at com.pega.pegarules.engine.database.Saver.save(Saver.java:522)
    at com.pega.pegarules.engine.database.DatabaseImpl.save(DatabaseImpl.java:3813)
    at com.pega.pegarules.engine.database.DatabaseImpl.save(DatabaseImpl.java:3797)
    at com.pega.pegarules.util.SystemSettings.setDynamic(SystemSettings.java:196)
    at com.pega.pegarules.engine.context.UsageDaemon.initialize(UsageDaemon.java:339)
    at com.pega.pegarules.engine.context.Agent.start(Agent.java:1180)
    at com.pega.pegarules.engine.context.PRNodeImpl.startNode(PRNodeImpl.java:1353)
    at com.pega.pegarules.engine.context.PREnvironment.finishInit(PREnvironment.java:1256)
    ... 18 more

STEPS TO REPRODUCE 

Run BIX extraction on PRPC 5.4sp2 system from the command line.

Root Cause

An error/omission in product documentation. There is a configuration setting that is needed to start the engine from the command line that is not documented.

Resolution

This issue is resolved by making the following change to the PRPC operating environment: 

1. To resolve the problem with the System-Work-Indexer class, in prconfig.xml file add the following:
                <env name="indexing/enabled" value="false" />

2.  To be able to run the bix extraction from the command line install HFix-5670, HFix-6419 and dependent hot fixes to the standalone BIX 5.4sp2 installation.  Do not apply these hot fixes to a 5.4sp2 PRPC system.  These hot fixes provide changes to the prprivate.jar and prpublic.jar files.  Replace the files in your lib/pega directory with these updated jars.