Rolling back and committing tracked data

You can roll back or commit data that has been imported using the import tool with the import.trackData property set to true.The tool lets you commit imported data, or roll back all non-committed data instances to their state immediately prior to when they were imported.

Use an active instance of the Pega Platform with the prpcServiceUtils.bat or prpcServiceUtils.sh script to roll back or commit tracked data. The tool only tracks and supports rolling back data instances that do not belong to the PegaRULES database name (Data-Admin-DB-Name).

To roll back or commit tracked data, follow these steps:

1. Configure the common properties in the prpcServiceUtils.properties file.

   Property name	Action
   pega.rest.server.url	Enter the URL for the REST service in the following format: http://<hostname>:<port>/context/PRRestService/tenanthash Include the tenant hash only for multitenant systems.
   pega.rest.username	Enter the operator name on the target system with access to REST services.
   pega.rest.password	Enter the password of the specified operator.
   pega.rest.proxy.host	Optional. Enter the host name of the REST proxy server. Do not use localhost as the host name.
   pega.rest.proxy.port	Optional. Enter the port for the REST proxy server.
   pega.rest.proxy.username	Optional. Enter the operator name on the REST proxy server with import and export access.
   pega.rest.proxy.password	Optional. Enter the password of the REST proxy operator.
   pega.rest.proxy.domain	Optional. Enter the domain of the REST proxy server.
   pega.rest.proxy.workstation	Optional. Enter the workstation ID for the REST proxy server.
   pega.rest.response.type	Enter the REST response type, either xml or json. The default value is json.
   user.temp.dir	Optional: Enter the full path to the temporary directory. Leave this blank to use the default temporary directory.

2. Specify whether to roll back or commit tracked data.

   Property name	Action
   manageTrackedData.operation	Specify whether to roll back or commit tracked data. Tracked data is data that has been imported using the import tool with the import.trackData property set to true. The valid values are: rollback - rolls back tracked data. commit - commits tracked data.

3. Save and close the prpcServiceUtils.properties file.

4. Run the prpcServiceUtils.bat or prpcServiceUtils.sh script. For example:

   prpcServiceUtils.bat manageTrackedData

   You can also pass one or more arguments:

   prpcServiceUtils script argument	Action
   artifactDir	Enter the full path to the output file location. The default is the /scripts/utils/logs directory.
   connPropFile	Enter the full path to the serviceConnection.properties file that includes information for multiple targets.
   poolSize	Enter the thread pool size. Default is 5.
   requestTimeOut	Specify how long the system waits for a response before failing with a timeout error. Default is 300 seconds.
   jobIdFile	Enter the path to the job IDs file that is generated by the asynchronous operation.

Open topic with navigation