UpdaterConfig.xml file
The settings in the UpdaterConfig.xml file contain the information that the Pega Synchronization Engine uses to connect to the Pega Synchronization Server. These settings also control how the Pega.Loader application responds when there is no package to run.
The UpdaterConfig.xml configuration file is installed with the Pega Synchronization Engine and is located in the following folder:
C:\ProgramData\Pegasystems\Updater\UpdaterConfig.xml
The following is an example of the UpdaterConfig.xml file, with the keys that you update highlighted:
The following table describes the keys in this file:
Key |
Description |
|
level |
Specify the log level. Choose from Trace, Debug, Information, Warning, Error, Critical and None, in descending order of verbosity. |
|
ShowNoPackageDialog |
Determines whether the Pega.Loader application displays a dialog if no package is loaded. If you are running unattended RPA robots, enter False to prevent the dialog from displaying – and requiring someone to cancel it. See also the AllowRunWithNoPackage key in the RuntimeConfig.xml file which determines if Robot Runtime can run if no package is loaded. |
|
productRepository |
Enter the URL to the Pega Synchronization Server. Ensure that this URL includes the port to connect to the server and the postfix /api/v1/. The following is an example: https://MySynchServer:5004/api/v1/ |
|
localServicePort |
The port that the local REST service uses to communicate between the Pega Updater Service and the Pega.Loader application. Only change this setting if there is a conflict with another application. |
|
PreFetchMins |
Enter the interval, in minutes, between times when the Pega Updater Service communicates with the Pega Synchronization Server to perform pre-fetch operations. If you enter zero (0), the systems gets the default value from the server. You define the product versions to be pre-fetched on the Pega Synchronization Server. |
|
Use64bitRuntime (3.1.13 or later) |
Enter True if you use the 64-bit version of Robot Runtime. Enter False if you use the 32-bit version of Robot Runtime. |
|
HideSplashScreen (3.1.13 or later) |
Enter True to hide the splash screen when the Pega Synchronization Server starts. Enter False to display the splash screen. |
|
KeepTryingMinutes (3.1.16.0 or later) |
Specify how long (in minutes) the Pega Updater Service tries to connect to Updater Server after the initial attempt. For example, if you enter 5, the Updater Service tries to connect to the Updater Server for five minutes. If you enter zero (0), the Updater Service only makes the initial attempt to connect, then stops. If you enter anything else, leave it blank, or omit the key from the file, the Updater Service attempts to connect indefinitely. A typical use case for using this setting is when the Pega Synchronization Server is available only when the user is on a VPN. When the user logs in to their machine, the Updater Service continues to try to connect to the Synchronization Server for the number of minutes that you specify. This allows the user's computer time to first connect to the VPN. Your entry should be enough to exceed the longest amount of time that the computer would require to connect to the VPN. |
|
ProxyServer (Pega Synchronization Engine 3.1.20.0 or later Pega Synchronization Server 3.1.19.0 or later) |
Use this key to define a proxy server when you connect to the Pega Synchronization Server. |
