Skip to main content

Table of Contents

Defining the database driver


Only available versions of this content are shown in the dropdown

Define a JDBC driver in your on-premises Pega Platform by using the Import Wizard and creating or updating a dynamic system setting.

By default, the PostgreSQL driver is included in Pega Platform for Pega Cloud Services environments. Do not upload an additional PostgreSQL driver to a Pega Cloud environment as it will cause conflicts with the driver already on the system.
Download the appropriate driver from your database vendor. The Java version of the driver must be compatible with the Java version of your application server.
  1. In the header of Dev Studio, click Configure Application Distribution Import .

  2. Select the database driver file that you obtained from your database vendor and then follow the steps in the Import Wizard to complete the import.

  3. Expand the SysAdmin category, and then click Dynamic System Settings.

  4. Search for the dynamic system setting instance whose Setting Purpose equals prconfig/database/drivers/default.

    • If the instance does not exist, click Create, enter the following values, and then click Create and open.
      • Short descriptionprconfig/database/drivers/default
      • Owning RulesetPega-Engine
      • Setting Purposeprconfig/database/drivers/default
    • If the instance already exists, click the row to open the instance.
  5. In the Value field, enter the fully-qualified class name for the JDBC driver that you import. If the Value field is already populated, separate the individual driver class names with a semicolon (;). See your database vendor documentation for the class names.

  6. Click Save.

  7. Restart each node in the cluster so that all tiers in the system recognize your new database driver.

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