SA-3647

Summary

The system administrator cannot redirect the log files to a different location even after entering the values in the WebSphere Application Server JVM properties. Also, the Pega configuration files (prconfig.xml, prlogging.xml, and log4j.xml) are not created after the deployment and restart of the JVM.

Error Messages

Not Applicable

Steps to Reproduce

Unknown

Root Cause

A defect or configuration issue in the operating environment using WebSphere Application Server

Resolution

There are three ways to tell Pega to look for configuration files (prconfig.xml, prlogging.xml, prmbeans.properties) outside of the EAR and inside of the prresources.jar file.

Approach #1: URL resource references

1. In the WebSpere Application Server Administrator Console, click Applications > Enterprise Applications > PRPC.
2. Click Resource References.
   Notice a couple of optional URLs to control Pega resources. By default, they are all mapped to url/pega/none and PRPC ignores them.
3. Use the following URLs:
   url/pegarules.config – points to configuration file (prconfig.xml)
   url/prmbeans.security – points to mbean properties file (prmbeans.properties)
   url/pegarules.logging.configuration – points to logging setup (prlogging.xml)
4. Each of these is repeated three times because EAR/e-tier deployment of Pega breaks the runtime into three parts:
   prweb.war (servlet container)
   EngineBMT (EJB container when using bean-managed transactions including browser-based interactins)
   EngineCMT (EJB and MDB services)
5. Define URLs using full URL syntax, file:///path/path/file . . .

Approach #2, IBM WebSphere custom properties or JVM Generic Arguments

Pega uses the following Java command line arguments if they are specified:
–Dpegarules.config=/path/and/file/name
–Dpegarules.logging.configuration=/xx/yy/zz/prlogging.xml
–Dprmbeans.security=/qq/rr/ss/prmbeans.security

1. In WebSphere Application Server, specify the “-D” command line arguments in one of two ways:
   In the JVM definition, explicitly add –D arguments as Generic JVM properties
   Use JVM custom properties as shown below.
2. In the following example, define the properties pega.logdir and pega.tmpdir, which are themselves referenced from the files prlogging.xml and prconfig.xml.

Approach #3, Specify Generic JVM argument or WebSphere Application Server JVM custom property
–Duser.home

Override the Java default ‘home’ directory by specifying
–Duser.home=/some/directory
Pega will look in the user.home directory for prlogging.xml, prconfig.xml, and prmbeans.properties.