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

DSS settings are overwritten and reset to default values



The requirement is to tune dynamic system settings (DSS) related to distributing fulltext search and indexing.
However, DSS settings are overwritten and reset to default values after restarting the application server.

The settings are associated to the Pega-SearchEngine ruleset and have a purpose prefixed with indexing/distributed/*
Examples are:
  • indexing/distributed/batch/numWorkers
  • indexing/distributed/batch/requestBatchSize
  • indexing/distributed/batch/maxRecords

Error Messages

Not Applicable.

Steps to Reproduce

  1. Change one or several of the affected DSS using Designer Studio. For example, set indexing/distributed/batch/requestBatchSize to 500
  2. Restart the application server or the JEE application
  3. Check the DSS setting. It is reset to the default setting of 100

Root Cause

From Pega 7.2.2, during the application node startup and shutdown, based on the DSS indexing/distributed/autonodecleanupandreindex, Pega engine cleans up the index directories of offline index nodes. The process also triggers automatic reindexing on that node that is starting up. This is done to avoid manual intervention and to meet quorum criteria (which is necessary for index writes to succeed).

For more information, refer to the below link:


Apply the following local change:

Set the below DSS to skip bootstrapping:

DSS Name: indexing/distributed/autonodecleanupandreindex 
Owning Ruleset: Pega-SearchEngine 
Value: false


Published 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