Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

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.

Issue: Error: Database-BadClassDef when using the Export tab in prdbutil

Updated on May 7, 2019


Using the Utilities > Export PegaRULES Process Commander Application Instances page in the Database Utilities application, prdbutil.war, you can export RuleSets and instances from a Process Commander database:

However, exporting from Process Commander sometimes generates one of the following errors:

  • Error: Database-BadClassDef-BadObjectClass <ClassName> Problem encountered when opening instance <instance name>
  • Error: Database-BadClassDef <ClassName> <Key>




Instead of using the Export tab in prdbutil to export instances. the best practice is to create a product rule. See How to specify application RuleSets in a product rule.

If you need to use prdbutil for export —for example when Process Commander is unavailable — stop and restart prdbutil.war (in the application server) to cause its rules cache to include any recently created classes, before starting the export operation .


Like other Process Commander nodes, the prdbutil.war application creates an in-memory rule cache when starting up. However, this is a one-time operation; the system pulse which regularly synchronizes the in-memory rules cache on true Process Commander nodes with actual rules stored in the database is not enabled on the prdbutil application. As a result, if you attempt to use the Database Utilities to export certain types of rules that were only recently created in Process Commander, they are not present in the prdbutil's rules cache and database errors are generated as described above.

Note: The pulse is disabled in prdbutil. As a result, prdbutil never updates its cache of classes after it starts. You must use one of the two solutions described above.

Have a question? Get answers now.

Visit the Support 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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us