prconfig.xml file

The prconfig.xml file is a XML file that defines installation and operating parameters for a Pega 7 node, including:

In a clustered system, a prconfig.xml file is present on each node.

Use of Dynamic System Settings

Many settings that in prior releases could be set only in the prconfig.xml file can optionally be set as dynamic system settings — data instances of the Data-Admin-System-Setting class. This approach eliminates the need to undeploy and redeploy your system to make changes to these settings. (The new or updated settings take effect only the next time the system is restarted.

Viewing the file

This file typically is placed in the WEB-INF/classes subdirectory of the application server directory. To view the prconfig.xml file for a node in your system:

  1. Select > System > Operations > System Management Application to start the System Management application. You may be prompted for authentication credentials.
  2. Select a node.
  3. Select the Configuration Management menu item.

Updates

Caution: Changes to this file may have dramatic effect on the operation and performance characteristics of your system. Make such changes only after careful planning and after review of documentation or consultation with Pegasystems support. Changes you make to this file take effect the next time you start the application server.

As a best practice, use an XML editor when changing the contents of this file. If no XML editor is available, use WordPad or a program editor rather than Windows Notepad.

As a best practice, use application server facilities to effect changes in this file:

  1. Undeploy Pega 7.
  2. Extract the current prconfig.xml file from the WAR file or EAR file.
  3. Edit the file as required.
  4. Repackage the WAR file or EAR file.
  5. Redeploy with the application server facilities.
  6. Restart the application server.

When Pega 7 is deployed as an enterprise application, the prconfig.xml file is contained in a jar file \APP-INF\lib\prresources.jar.

Related Topics IconRelated terms