Support Article
Pega Application server fails to start
SA-85327
Summary
On clearing the Pega Cache tables, the Pega Application server does not start. This occurs post Pega Platform 8.2.1 upgrade.
Error Messages
Failed to compile rule: /com/pegarules/generated/pega_processengine_workutilities.java
Error compiling: com/pegarules/generated/pega_processengine_workutilities; see class's compile log file.
Exception
com.pega.pegarules.pub.runtime.LibraryFunctionNotFoundException: Failed to extract 'pega_processengine_workutilities'
Steps to Reproduce
- Upgrade Pega Platform 7.2.1 to Pega Platform 8.2.1.
- Clear the Pega Cache tables.
- Restart the Pega Application server.
Root Cause
A defect or configuration issue in the operating environment.
In versions prior to Pega 8 platform, the 'base/mail-1.5.5.jar' was shipped out-of-the-box with the Pega Platform. The JAR file name was changed to 'mail-1.5.5.jar' in the Pega 8 Platform. This was the correct JAR which the application must load while starting the application server. The classes in these two JARs conflicted, which resulted in class load failure. Therefore, the Pega Application server failed to start.
Resolution
Perform the following local-change:
- Stop the application server nodes.
- Execute the query on the pr_engineclasses table present in the Rules schema:
update <rules schema name>.pr_engineclasses set pzcodeset = 'pega-enginecode-nouse' where pzjar = 'base/mail-1.5.5.jar';
- Clear the Pega Temporary directory content.
- Restart the Application server nodes.
Published August 15, 2019 - Updated December 2, 2021
Have a question? Get answers now.
Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.