Skip to main content

Table of Contents

Changing node settings by modifying the prconfig.xml file


Only available versions of this content are shown in the dropdown

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.

Changes to the 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.

  1. Stop Pega Platform.

  2. Undeploy Pega Platform.

  3. Extract the current prconfig.xml file from the WAR file or EAR file.

  4. 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.
    <env name="agent/enable" value="true" />
  5. Repackage the WAR file or EAR file.

  6. Redeploy Pega Platform with the application server facilities.

  7. Restart the application server to implement the changes to the prconfig.xml file.

Changes that are made to this file take effect the next time that the application server starts.
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us