Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Build notes: Pega RPA Service 3.1

Updated on November 28, 2022

Build notes describe the changes that are included in each build that is created for the Pega RPA Service. Before you install one of these builds, familiarize yourself with the new features, resolved issues, and other changes. For more information, see Robotic Processing Automation (RPA) Service.

To download a build, see Download Pega RPA software. For information on system requirements, review the installation instructions.

Summary of changes

The changes that are included in the various Pega RPA Service builds are listed in the following tables:

Pega RPA Service 3.1 build notes (19.1 only)

Item number

Description

Build 3.1.29 — November 29, 2022 — initially bundled with Pega Robotic Automation 19.1.118

BUG-759746

This build resolves an issue that caused calls from RPA Service to Robot Manager to fail after RPA Service was running for an extended period of time.

ISSUE-46938

This build corrects a null reference exception to ensure that controls with a null name value are properly processed.

US-500944

This build speeds the retrieval of managed accounts from BeyondTrust. Use the new Application, AccountName, accountLimit, and accountName options in the CredentialManagerConfig.xml file to implement the new retrieval method. For more information, see CredentialManagerConfig.xml file.

Note: If you are installing build 19.1.118.0 to use BeyondTrust’s new functionality for retrieving managed accounts, ensure that you also have RPA Service 3.1.29 or later installed.

Assemblies

Pega.RpaService.Service.exe
Pega.RpaService.Scheduler.exe

SchedulerDefinitions.xml
OpenSpan.Security.dll

Build 3.1.28 — November 02, 2022 — initially bundled with Pega Robotic Automation 19.1.117

BUG-746498

This build corrects an issue that occurred on Windows Server operating systems that could prevent Robot Manager from stopping a Runtime bot.

Assemblies

Pega.RpaService.Scheduler.exeNot applicable

Build 3.1.27 — October 14, 2022 — initially bundled with Pega Robotic Automation 19.1.116, and later bundled with Pega Robotic Automation 22.1.1 and later.

US-494790

This build updates the system to avoid a potential security issue.

Assemblies

Not applicable

Not applicable

Item number

Description

Assemblies

Build 3.1.26 — July 08, 2022 — bundled with Pega Robotic Automation 19.1.111

US-481014

This build allows you to specify the proxy for the Pega RPA Service separately from the proxy that is required for Robot Manager.
This setting only applies to BeyondTrust connections.

For example, enter the external URL that you want to use as a proxy in the proxyAddress key. This key is located in the CredentialManagerConfig.xml file.

Enter none or leave this key blank to disable the machine default proxy.

Pega.RpaService.Common.dll
Pega.RpaService.Service.exe
OpenSpan.Security.dll
CredentialManagerConfig.xml
RpaService.config

Build 3.1.25

 

The changes in this build were released in build 3.1.26.

 

Build 3.1.24 — May 27, 2022 — bundled with Pega Robotic Automation 19.1.109

US-465503

This build adds support for Pega Robotic Automation version 22.1.

Pega.RpaService.Common.dll

Build 3.1.23 — January 24, 2022 — bundled with Pega Robotic Automation 19.1.99

US-456458

This build updates the Pega RPA Service to correct Pega Robot Runtime BUG-696389. If you are integrating with BeyondTrust, install Pega RPA Service 3.1.23 or later.

OpenSpan.Security.dll
Pega.ClientCredentialProvider.dll

Build 3.1.22 — October 27, 2021 — bundled with Pega Robotic Automation 19.1.94

BUG-676749

This build ensures that when you include the WaitForAutomations key in the RuntimeConfig.xml file, Robot Runtime waits for all automations to stop before shutting down.

Pega.RpaService.Common.dll
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe

ISSUE-95469

Modifies the ScheduledModeUnlockScreen key in the RpaService.config file to accept lowercase entries.

RpaService.config

Build 3.1.21 — October 07, 2021 — bundled with Pega Robotic Automation 19.1.92

US-437222

This build changes the installation process to no longer display command-box windows when you install the Pega RPA Service.

PegaRPAService.aip

Build 3.1.20 — September 16, 2021 — bundled with Pega Robotic Automation 19.1.91

US-434072
US-434090

To enhance security, this build updates the following files:

  • log4net.dll to version 2.0.12
  • Newtonsoft Json.NET framework to version 13.0

log4net.dll
newtonsoft.json.dll
Pega.RpaService.Common.dll

Build 3.1.19 — August 20, 2021 — bundled with Pega Robotic Automation 19.1.89

EPIC-66956

This build provides a security update to safeguard against the Veracode CWE 117 error — Improper Output Neutralization — which allows for the storage of sensitive information in memory.

Pega.RpaService.Common.dll
Pega.RpaService.CredentialManager.dll
CredMgr.exe
SessionMgr.exe
Pega.RpaService.Tools.exe

Build 3.1.18

 

The changes in this build were released in build 3.1.19.0.

 

Build 3.1.17 — June 9, 2021 — bundled with Pega Robotic Automation 19.1.85

BUG-645156This build removes the heartbeat buffer of five seconds for the heartbeat interval, sending the heartbeat in a timespan that matches the specified heartbeat interval.Pega.RpaService.Service.exe
BUG-641716This build resolves an issue that could prevent successful RDP connection login if no disclaimer screen is present.Pega.RpaService.Scheduler.exe

Build 3.1.16 — January 25, 2021 — bundled with Pega Robotic Automation 19.1.73

BUG-594960This build resolves an issue where a disclaimer screen would block the Server Bot Framework from starting a robot. SchedulerDefinitions.xml
Pega.RpaService.Common.dll
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe

Build 3.1.15 — September 14, 2020 — bundled with Pega Robotic Automation 19.1.61

EPIC-63220

This build updates the endpoints for all calls that the Pega RPA Service makes to provide support for Pega Robot Manager 8.5.

Pega.RPAService.Common.dll
Pega.RPAService.Service.exe

Build 3.1.14 — July 17, 2020 — bundled with Pega Robotic Automation 19.1.50

EPIC-63194

This build modifies the CredMgr.exe program to ensure that it includes the same functionality available from the CredMgr UI. The following changes were made:

  • The Robot index is no longer added if no robot index is passed.
  • Adds validation when you remove credential entries using the CredMgr.exe program.
  • Simplifies the requirements for removing entries.

OpenSpan.Security.dll
CredMgr.exe

BUG-575637
US-370979

This build adds the *.exe.config files to the version manifest/bundle and includes these files in the cache version folder with their corresponding .exe files.

N/A

Build 3.1.13 — June 01, 2020 — bundled with Pega Robotic Automation 19.1.44

EPIC-62795

This build changes the Credential Manager UI for the Pega RPA Service to ensure that the application displays correctly when you have the screen resolution of 1280 x 720.

CredMgrUI.exe

EPIC-62787

This build includes the following changes:

  • Ensures that the Pega RPA Service accurately reports the status of Robot Runtime and can log out of the computer as requested when a single Robot Runtime is enabled for a computer and Remote Desktop Protocol (RDP) is used to connect to the computer.
  • Changes the CyberArk and BeyondTrust credential providers to support all the parameters that are passed by the GetCredentials overload method to call the AsoManager and credential store, with the exception of the Name and WorkGroup parameters.
  • Adds the defaultProvider attribute, which you can use to define a custom credential provider to override DPAPI as the default credential provider.

Pega.RpaService.Common.dll
Pega.RpaService.Loader.dll
Pega.RpaService.Scheduler.dll
Pega.RpaService.Service.dll

Build 3.1.12 — April 24, 2020 — bundled with Pega Robotic Automation 19.1.39

EPIC-62070

This build includes the following changes:
  • The RPA Service no longer writes to the RuntimeLaunchState.dat file in on-demand mode.
  • The SchedulerDefinitions.xml file includes support for Windows Server 2019. 
  • The RPA Service log now includes all AppSetting values from the RPAService.config.xml file. 
SchedulerDefinitions.xml
RpaService.config
Pega.RpaService.Common.dll
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe

US-355454

This build modifies the installer to adjust permissions on the RPAService folder in the ProgramData folder to permit the Scheduler program to write log information.

PegaRPAServiceSetup.exe

US-358012

This build enhances credential provider support for Robot Runtime and the Robotic Process Automation (RPA) Service in several ways:

  • Ensures that all credential providers process requests with WorkGroups and replaceable system values in the same way. 
  • Provides additional logging and a new domain attribute for CyberArk in the CredentialManagerConfig.xml file.
  • Updates the client credential provider to include all system parameters with each credential call.

For more information, see Integrating a Client Credential Provider.

OpenSpan.Security.dll
Pega.ClientCredentialProvider.dll

Build 3.1.11 — April 13, 2020 — bundled with Pega Robotic Automation 19.1.38

BUG-551870

This build ensures that the Pega RPA Service uses the value defined for the ScheduledTaskStartBoundary key in the RPAService.config.xml file to schedule the runtime task.

Pega.RpaService.Common.dll
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe
CredMgrUI.exe

BUG-552492

This build ensures that the Pega RPA Service uses the BaseURL key from the AppSettings section in the RPAService.config.xml file. The RPA Service uses the value that you specify for this key, if present, instead of the BaseURL key value in the RobotManager section of the CommonConfig.xml file.

Pega.RpaService.Common.dll
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe
CredMgrUI.exe

Build 3.1.10 — March 07, 2020 — bundled with Pega Robotic Automation 19.1.32

Note: Pega Robotic Automation builds 19.1.30-19.1.34 were removed from Digital Delivery after we discovered several bugs, some of which were resolved in RPA Service 3.1.11. Please download 19.1.38 from Digital Delivery. This build contains RPA Service 3.1.11. All features and fixes from RPA Service 3.1.10 are available in 3.1.11.

US-317631

This build adds support for running multiple Runtime sessions on a single Windows machine if the machine supports RDP connections.

To specify the maximum number of robots that you want to register with Robot Manager, use the new maximumRobots option in the RobotManager section of the CommonConfig.xml file.

This build also updates the CredMgrUI.exe and CredMgr.exe programs to support multiple Runtime sessions. When you set the maximum number of robots to two or more, a new RobotIndex field appears  in the CredMgrUI.exe and CredMgr.exe programs when you specify the WindowsUser and RuntimeUser keys in the CredentialManagerConfig.xml file. Ensure that each robot has unique WindowsUser and RobotIndex entries.

This build also adds the following options to the AppSettings section in the RPAService.config.xml file:

  • To select the screen resolution to use for new RDP connections, use the RemoteDesktopSessionScreenResolution option.
  • To specify the maximum number of concurrent Runtime robots that can start at the same time, use the RemoteDesktopSessionStartupConcurrency option. The Synchronization Engine Product Loader also uses this value.
  • To set the wait time, in seconds, between the creation of each RDP session when starting multiple robots at the same time, use the RemoteDesktopSessionCreationWaitTimeSec option.
  • To fill in ASO.db file passwords for multiple Runtime robots and prevent ASO dialogs from appearing when running projects for the first time, use the new Pega.RpaService.Tools.exe utility.
Note: This build removes the Framework .dll dependency except for .dll files that are related to credential providers.

CommonConfig.xml
CredentialManagerConfig.xml
RpaService.config
Pega.RpaService.Common.dll
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe
Pega.RpaService.Tools.exe
SessionMgr.exe
CredMgr.exe
CredMgrUI.exe

US-319231

This build adds the ConsecutiveInvalidLoginLimit option to the AppSettings section of the RPAService.config.xml file. Use this option to limit the number of failures allowed before the RPA Service stops trying to register with Pega Robot Manager.

For example, if you enter 10, the RPA Service attempts to register with Pega Robot Manager up to10 times. If it fails to register 10 times, you must then restart the RPA Service.

CommonConfig.xml
CredentialManagerConfig.xml
RpaService.config
Pega.RpaService.Common.dll
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe
Pega.RpaService.Tools.exe
SessionMgr.exe
CredMgr.exe
CredMgrUI.exe

US-349008

This build resolves a security vulnerability in the Pega RPA Service by changing the default behavior for handling locked screens during unattended robotic sessions when running in Scheduled mode.

CommonConfig.xml
CredentialManagerConfig.xml
RpaService.config
Pega.RpaService.Common.dll
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe
Pega.RpaService.Tools.exe
SessionMgr.exe
CredMgr.exe
CredMgrUI.exe

Build 3.1.9 — February 7, 2020 — bundled with Pega Robotic Automation 19.1.27

BUG-538964
BUG-538133

This build adds security enhancements to resolve potential vulnerabilities.

Installer changes

EPIC-59173

This build adds security enhancements to resolve potential vulnerabilities.

OpenSpan.Branding.dll
OpenSpan.dll
OpenSpan.Runtime.Core.dll
OpenSpan.Security.dll
Pega.ClientCredentialProvider.dll
Pega.Interop.dll
Pega.RpaService.Common.dll
Pega.RpaService.CredentialManagerUI.exe
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe
Pega.RpaService.SessionManager.exe

ISSUE-72086

This build adds a missing registration payload password field so that the RPA Service can register with Robot Manager.

Not applicable

Build 3.1.7 — February 7, 2020 — bundled with Pega Robotic Automation 19.1.26

Note: Pega Robotic Automation build 19.1.26 was removed. Please download 19.1.27 that contains RPA Service 3.1.9  All features and fixes from RPA Service 3.1.7 are available in 3.1.9.

EPIC-60451

This build implements full support of the BeyondTrust credential provider for Robot Runtime. You can use your existing BeyondTrust portal to provide credentials for the registration operator, Windows user, Runtime user, ASO manager, and Credential Store.

CommonConfig.xml
CredentialManagerConfig.xml
RpaService.config
OpenSpan.Branding.dll
OpenSpan.dll
OpenSpan.Runtime.Core.dll
OpenSpan.Security.dll
Pega.ClientCredentialProvider.dll
Pega.Interop.dll
Pega.RpaService.Common.dll
CredMgr.exe
CredMgrUI.exe
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe
SessionMgr.exe
System.ValueTuple.dll

Build 3.1.6 — December 4, 2019 — bundled with Pega Robotic Automation 19.1.20

ISSUE-68867

This build removes the requirement of an internet connection during the installation process.

Installer MSI files

US-328600

This build adds support to RPA Service for a new robot profile endpoint in Robot Manager. It reverts to an existing endpoint when a new endpoint does not exist.

Pega.RpaService.Service.exe

Build 3.1.5 — October 11, 2019 — bundled with Pega Robotic Automation 19.1.14

BUG-512701

This build resolves an issue that could occur in the CommonConfig.xml file if you enabled the CredentialManager server and set the providerType to DPAPI.

OpenSpan.Security.dll

Build 3.1.4 — September 27, 2019 — bundled with Pega Robotic Automation 19.1.13

BUG-508009

This build adds the ScheduledTaskStartBoundary configuration setting to the RPAService.config.xml file. Use this setting to ensure that the start boundary does not occur before the scheduled task.

OpenSpan.WinLogon.Scheduler.dll

US-323726

This build adds the BaseURL key to the AppSettings section in the RPAService.config.xml file. The system uses the value that you specify in this key instead of the BaseURL key value in the RobotManager section of the CommonConfig.xml file.

Note: This key only applies to the Pega RPA Service.

CredentialManagerConfig.xml

US-323723

This build enables you to get and set custom credentials by using the IClientCredentialProvider interface.

To set up custom credentials, use the CredentialManager server options in the CommonConfig.xml file, and make corresponding entries in the CredentialManagerConfig.xml file.

For the credential provider, set the providerType attribute in the CredentialManagerConfig.xml file to Client and include values for the assemblyName and className attributes.

CredentialManagerConfig.xml
OpenSpan.ApplicationFramework.dll
OpenSpan.Controls.dll
OpenSpan.Security.dll
Pega.ClientCredentialProvider.dll

Build 3.1.3 — August 19, 2019 — bundled with Pega Robotic Automation 19.1.7

US-318438

This build modifies the Pega RPA Service to use the correct argument format when passing the workgroup option to the Pega.Loader.exe program.

In addition, this build also updates the Pega RPA Service to use a signed version of the Framework binaries and modifies the CredMgrUI.exe program to ignore empty credentials.

FrameworkBinaries/OpenSpan.Branding.dll
FrameworkBinaries/OpenSpan.Runtime.Core.dll
FrameworkBinaries/OpenSpan.Security.dll
FrameworkBinaries/OpenSpan.dll
Pega.RpaService.Common.dll
Pega.RpaService.CredentialManagerUI.exe
Pega.RpaService.Loader.exe

ISSUE-25935

This build adds updated copyright information for all versioned files.

All versioned files.

Build 3.1.2 — June 28, 2019 — bundled with Pega Robotic Automation 19.1.2

US-267153

This build modifies the Credentials Manager (CredMgr.exe/CredMgrUI.exe) (DPAPI) tools to accept the workgroup field when you save credentials. This information can be retrieved by the Pega RPA Service or Pega Robot Runtime.

This build also adds workgroup support to the CyberArk and DPL credential providers.

These changes allow you to retrieve different Registration Operator, Windows User, and Runtime User credentials based on your current workgroup.

Pega.RpaService.Common.dll
OpenSpan.Security.dll
CredMgr.exe
CredMgrUI.exe
Pega.RpaService.Loader.exe
Pega.RpaService.Scheduler.exe
Pega.RpaService.Service.exe

ISSUE-62354

This build adds a default heartbeat interval of 30 seconds. This default is used if the heartbeat interval is not set on Pega Platform.

This build also modifies the log message if an exception is thrown.

Pega.RpaService.Service.exe

BUG-486961

This build corrects a problem that prevented the system from correctly reading the value of the enabled attribute in the log4net section of the RPAService.config.xml file.

Pega.RpaService.Common.dll

Build 3.1.1.0 — May 31, 2019 — bundled with Pega Robotic Automation 19.1.1.0

Not applicable

This is the initial released build of the Pega RPA Service for Pega Robotic Automation 19.1.

Not applicable

  • Previous topic Build notes: Pega Browser Extension 3.1
  • Next topic Build notes: Pega Package Server and Server Status Page 3.1

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us