Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Pega 7.4 upgrade fails on IBM JDK 1.8



When upgrading to Pega 7.4, OutOfMemory exception occurs and the upgrade script fails. This occurs on a system with adequate memory (8 GB) and IBM JDK 1.8.

Error Messages

[java] [ main] [ ] [ ] [ ] (ary.ClassMapDatabasePageReader) INFO - Reading the class definitions
[java] JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" at - please wait.
[java] JVMDUMP032I JVM requested System dump using '/shared/upgrade74/PegaInstallTemp 21.38.17/load/core.20180524.215008.1957.0001.dmp' in response to an event [java] java.lang.OutOfMemoryError: Java heap space

Steps to Reproduce

  1. Update from Pega 7.1.8 to Pega 7.4.
  2. Run the Pega 7.4 upgrade script using IBM JDK 1.8.

Root Cause

A defect in Pegasystems’ code or rules.

The Pega setupDatabase.xml Ant script does not detect JDK 1.8 correctly. It also does not set the standard JVM maximum memory argument (-Xmx). It sets an optional memory argument which is not deciphered by IBM JVM.


Perform the following local-change:

Edit the setupDatabase.xml script and add detection for JDK 1.8.


Published July 23, 2018 - Updated December 2, 2021

Was this useful?

0% found this useful

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

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