Creating a migration configuration template

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 inerrupting 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 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: Configure the data migration dynamic system settings.
    1. In the Change value field, enter the value to use.
      • 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.
    2. Click Add setting to add settings.
  10. Click Save.
What to do next: Run the configuration. Wait for the configuration to finish before reverting the configuration and running another configuration.