Table of Contents

Creating a migration configuration template


Only available versions of this content are shown in the dropdown

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

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 Configure Application Tools Data 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.

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.
Did you find this content helpful?

Have a question? Get answers now.

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