SA-307

Summary

Cannot log in to the application after the Java Virtual Machine (JVM) was restarted.

Error Messages

**Date and time**,732 [   <Server_Host>] [          ] [                    ] (      etier.impl.EngineStartup) ERROR   - PegaRULES initialization failed. Server: <Server_Host>
com.pega.pegarules.pub.context.InitializationFailedError: PRNodeImpl init failed
    at com.pega.pegarules.session.internal.mgmt.PREnvironment.getThreadAndInitialize(PREnvironment.java:393)
.
.
.

Caused by: 
java.lang.NoSuchMethodError: com/pega/pegarules/session/internal/mgmt/PRRequestorImpl.acquire(Ljava/lang/String;Ljava/lang/String;Ljava/util/Map;Z)Lcom/pega/pegarules/session/internal/mgmt/PRRequestorImpl;

Steps to Reproduce

1. Apply multiple hotfixes that contain engine java classes using Import Archive tool instead of Update Manager.
2. Restart the JVM.

Root Cause

A software use or operation error:

DL items containing hotfix jar archives must be installed using Update Manager and not using Import Archive tool. Update Manager processes the hotfixes bundled in DL for appropriate dependencies and then applies the code change in correct order. Installing hotfixes with Import Archive tool leads to inconsistent state of engine classes causing PegaRULES engine to fall.

Resolution

Perform the following local-change:
Import Archive tool modifies pzpatchdate column in pr_engineclasses table with the date when hotfix jar was applied. 
Use the following patchdate strategy to revert to an older, July 12, patch state. Modify prbootstrap.jar/prbootstrap.properties from the deployed PRPC archive and add these lines:

com.pega.pegarules.bootstrap.codeset.version.Pega-EngineCode=06-02-20
com.pega.pegarules.bootstrap.codeset.patch.Pega-EngineCode=2014-04-12 21.14 GMT

Bring up the JVM. Install the necessary hotfix DLs, which were imported earlier using Import Archive, by Update Manager.
Shut down the JVM, and remove the above two lines from prbootstrap.jar/prbootstrap.properties to allow PegaRULES Engine to use pick up the latest code changes.