Skip to main content

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

Creating a migration configuration template

Updated on April 6, 2022

Ensure a successful migration of data into your application by using a configuration template to set up your environment.

Before you begin: You must have the PegaRULES:DatabaseAdministrator role to run configuration templates.
Configuration templates belong to the application in which they are configured. Configure the template to disable processes that are not live and that are not required for migration so that the resources are free and are not interrupting the migration process. Such processes might slow down database inquiries and cause the import to fail.
  1. In the header of Dev Studio, click ConfigureApplicationToolsData Migration Settings.
  2. In the Template field, do one of the following actions:
    • Select an existing template.
    • Select Create new.
      1. In the Clone from field, select a template to use as a starting point for the new configuration.
      2. In the Name field, enter a name for the template.
  3. Optional: In the Disable history section, click Disable history for all work classes.
  4. Optional: In the Disable database indexes and background processing section, select the fields to remove from indexes.
    Do not remove indexes for fields that are used for matching during the data import or for fields that are used by the lookup option.
    1. Click Add class.
    2. In the Class field, select the class that you want to configure.
    3. To select additional properties to exclude, in the Exclude properties column, click Edit.
    4. Select the properties to exclude from indexing and click Submit.
    5. In the Disable DB Indexes column, select or clear the check box.
    6. In the Disable auto vacuuming column, select or clear the check box.
    7. To add additional classes, repeat steps a through f.
  5. Optional: In the Disable queue processors section, click Add queue processor, select the queue processors that you want to disable, and click Submit.
  6. Optional: In the Disable agents section, click Add agent, select the agents that you want to disable, and click Submit.
  7. Optional: In the Disable job schedulers section, click Add job scheduler, select the job schedulers that you want to disable, and click Submit.
  8. Optional: In the Disable listeners section, click Add listener, select the listeners that you want to disable, and click Submit.
  9. Optional: In the Dynamic system settings section, change the values of the data migration dynamic system settings.
    For optimal performance, use the following dynamic system settings and default values that are displayed in the Dynamic system settings section:
    • Pega-RULES.import/BatchSize – Specifies the number of records in a batch being imported.
    • Pega-Engine.prconfig/pradapter/loggingLevel/default – Specifies the default logging level for the system log. This setting overwrites the setting in the JVM properties file.
    • Pega-RULES.indexing/enabled – Specifies whether full text search indexing is enabled.
    1. In the Change value field, enter a new value.
    2. To add additional settings, click Add setting.
  10. Click Save.
What to do next: Run the configuration by clicking Execute configuration in the Configuration template section. Wait for the configuration to finish before reverting the configuration and running another configuration.

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