Changing node settings by modifying the prconfig.xml file
Although it is a best practice to change system configuration settings by modifying the dynamic system settings, you can also change individual node settings in on-premises environments by modifying system settings in the prconfig.xml file.
prconfig.xml
file can affect the operation
and performance characteristics of your
Pega Platform
system. Make
changes only after careful planning and after reviewing documentation or consulting with
Pegasystems
Pega Support.
Dynamic system settings can override prconfig.xml settings when your
Pega Platform database is configured to retrieve its data using JNDI,
and the prconfig.xml file for a given node has the following setting:
<env name="initialization/settingsource" value="merged" />. See the
appropriate deployment guide for your system for information on configuring JNDI in the
context.xml file.
Edit the prconfig file on the application server.
- Stop Pega Platform.
- Undeploy Pega Platform.
-
Extract the current
prconfig.xmlfile from the WAR file or EAR file. - Edit the file as required.Entries are in the format
<env name="ParameterName" value="ParameterValue" />, where ParameterName and ParameterValue are set to the appropriate values.For example: <env name="agent/enable" value="true" /> - Repackage the WAR file or EAR file.
- Redeploy Pega Platform with the application server facilities.
- Restart the application server to implement the changes to the prconfig.xml file.
Previous topic Setting the outbound port for cluster communication Next topic Downloading and viewing the prconfig.xml file for a specific node