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

Failed to extract 'pega_rules_utilities' while running update



LibraryFunctionNotFoundException occurs during Pega 7.1 update to Pega 7.4.

Error Messages

[ ] [STANDARD] [ ] [ ] (lyGeneratedKey._baseclass.When) ERROR - Exception caught while evaluating when Failed to extract 'pega_rules_utilities'

Errors in the pega_rules_utilities Compile logs:

ERROR in \com\pegarules\generated\ (at line 132) java.util.Iterator enum = objListPage.getProperty("pxResults").iterator();    

Syntax error on token "enum", delete this token

Steps to Reproduce

Update Pega 7.1  to Pega 7.4.

Root Cause

On querying the database with  the following query, a record was found with an old version of the doRafHTMLProperty function (Pega-RULES:06-01-01 ruleset).

select * from pegarules.pr4_rule_library where pzinskey like '%DORAFHTMLPROPERTY%';

In the earlier versions of Pega, the doRafHTMLProperty function contained references to a variable named 'enum'. Since, 'enum' is a reserved word in later Java releases, these references are replaced with 'enum1' in Pega 7.

Therefore, any code that still references 'enum' fail to compile in Pega 7.


Perform the following local-change: 
  1. Back up the pr4_rule_library table.
  2. Run the following query to remove references to the older version of the function.

    delete from pegarules.pr4_rule_library where pzinskey like '%DORAFHTMLPROPERTY%' and pyrulesetversion='06-01-01';
  3. Resume the upgrade.
Suggest Edit

Published April 12, 2019 - Updated December 2, 2021

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