Use an active instance of the Pega 7 Platform with the prpcServiceUtils.bat or prpcServiceUtils.sh script to import archive files across multiple systems.
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 | Enter the host name of the REST proxy server. Do not use localhost as the host name. |
pega.rest.proxy.port | Enter the port for the REST proxy server. |
pega.rest.proxy.username | Enter the operator name on the REST proxy server with import and export access. |
pega.rest.proxy.password | Enter the password of the REST proxy operator. |
pega.rest.proxy.domain | Enter the domain of the REST proxy server. |
pega.rest.proxy.workstation | Optional: Enter the workstation ID for the REST proxy server. |
user.temp.dir | Optional: Enter the full path to the temporary directory. Leave this blank to use the default temporary directory. |
prpcServiceUtils.properties file property name | Action |
---|---|
import.archive.path |
Enter the relative path to the archive from the \utils\ folder or the full path to the archive. If the path is a folder, the tool processes all archive files in that folder. |
import.mode |
Enter the import mode:
|
import.existingInstances |
Specify how the import action handles existing instances:
|
import.nofailonerror |
Set to true to skip instances that fail to import and continue after an import failure. Set to false to stop the import if any import action fails. |
import.commitRate | Specify the number of data instances processed with each database commit to balance memory usage and performance. The default of 100 is sufficient for most environments. |
import.compileLibraries | Specify whether to compile libraries after import. Default is true. |
import.allowImportWithMissingDependencies | Specify whether to allow the import to continue even if the archive is dependent on missing products. Default is false. |
import.enable.defaultcontext | Specify whether to allow triggers for the Pega 7 Platform to run while performing command-line imports. Default is false. To allow triggers to run during imports, uncomment this property and set to true. |
import.codeset.name | Optional: Enter the name of the code set to receive the Java .class files. |
import.codeset.version | Optional: Enter the code set version. |
import.async |
Specify whether to run the process in asynchronous mode and queue the jobs. Set to true (default) to return a job ID for each operation that you can use later to check the status. |
import.trackData | Specify whether to import only data, that is, anything that is not in PegaRULES. When true, data, including DDL changes, is imported and tracked. Tracked data can later be rolled back or committed using the manage tracked data tool. |
Run the prpcServiceUtils.bat or prpcServiceUtils.sh script. For example:
prpcServiceUtils.bat --import
prpcServiceUtils script argument | Action |
---|---|
--connPropFile | Enter the full path to the connection.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. |