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

Environment hangs as a result of OutOfMemoryError in environment



OutOfMemoryError occurs in the Pega environment. As a result, the environment hangs.

Error Messages

[8080-exec-10] [TABTHREAD2] [ ] [:01.01.01] (il.classloader.PRClassLoaderDB) ERROR | your_user - (com.pega.pegarules.exec.internal.util.classloader.PRClassLoaderDB[email protected]) Error in defineClass: com.pegarules.generated.ruletype.ra_action_rulename_17fe33882c118baf8e4d4b79c3d1e541
java.lang.OutOfMemoryError: Metaspace

Steps to Reproduce


Root Cause

The Metaspace is a form of JVM internal memory (not part of the heap where objects are stored) used for class loading or mapping and similar Java processes. It frequently needs to be enlarged proportionate to the JVM size.

In this case, Pega loaded a class associated with a custom rule, however, there was no free Metaspace memory to store that class mapping.


Perform the following local-change:

Increase the MaxMetaspaceSize by increments of 512M or 1024M from its previous value.

Suggest Edit

Published September 21, 2018 - Updated October 8, 2020

Did you find this content helpful? Yes No

Have a question? Get answers now.

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

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