Skip to main content

Configuring Robot Runtime 8.0 SP1 2019 and later to work with Robot Manager 6 in RPA implementations

Suggest edit Updated on December 13, 2021

If you are using Pega Robotic Automation version 8.0 SP1 2019 or later, to configure Robot Runtime, complete the following instructions.

If you are using a different version, see Configuring Pega Robot Runtime in RPA implementations.

Before you begin

Perform the steps in Enabling the Pega RPA Service to simulate a Secure Attention Sequence.

To run Pega Robot Runtime in Robotic Process Automation (RPA) implementations as a user who differs from the currently logged in Windows user, you must relocate and modify the configuration files. Although the default location for configuration and logging files is the user-specific %AppData%\OpenSpan folder, instead use the %ProgramData%\OpenSpan folder, which is accessible to all Windows users.

  1. From the %ProgramFiles%\OpenSpan folder, copy the RpaSchedule.json file into the C:\programdata\OpenSpan folder.
  2. From the %ProgramFiles%\OpenSpan folder, copy the RuntimeConfig.xml file into the C:\programdata\OpenSpan folder.
  3. Copy the SchedulerDefinitions.xml file to the appropriate folder:
    • If this computer is part of a domain, from the %ProgramFiles%\OpenSpan folder, copy the SchedulerDefinitions.xml file into the C:\programdata\OpenSpan folder.
    • If this computer is part of a workgroup, from the %ProgramFiles%\OpenSpan folder, copy the SchedulerDefinitions-local.xml file into the C:\programdata\OpenSpan folder and rename it to SchedulerDefinitions.xml.
  4. Open the SchedulerDefinitions.xml file and ensure that the LogonDisclaimer key is set to False. The enabled key is configured in the appropriate operating system section in the SchedulerDefinitions.xml file. The following is an example:
<MatchSet name="Disclaimer" mode="SignIn" matchSuccess="Continue" matchFailure="Stop" enabled="true">
    <Match type="PushButton" name="OK">
        <Action type="execute" />
  1. Open the CommonConfig.xml file and change the ConfigurationLocation key. For example:
  1. Ensure that there is an RPAServiceOperator value in the RobotManager key the CommonConfig.xml file. For example:
<Server name="RobotManager" enabled="true" baseURL= RPA="true" workgroup="Savings accounts" robotName="{MachineName}" authenticationType="Basic" RPAServiceOperator="{MachineName}_RPA" />
  1. Save and then close the CommonConfig.xml file.
  2. Open the RuntimeConfig.xml file, and then make the following changes:
    • In the fileName key for Log4Net files, specify the appropriate file names.
    • In the packageServer key, set the baseUrl to the location of the Package Server.
    • In the Shutdown section, set the Behavior value key to WaitForAutomations. For more information, see Runtime configuration settings.
  3. Save and then close the RuntimeConfig.xml file.
  4. From the install folder, copy the RPAService.config file into the %ProgramData%\OpenSpan folder.
  5. Open the RPAService.config file that is located in %ProgramData%\OpenSpan folder. Make the following changes:
    • In the enabled key for Pega RPA Service, enter true.
    • In the Mode key, if you use schedules provided by Pega Robot Manager 6, choose OnDemand. If you use schedules that are defined locally in the RpaSchedule.json file, choose Scheduled.
    • In the authorizedGroup key, specify who is granted access. The default is Everyone, which does not restrict access.
  6. Save and then close the RPAService.config file.
  7. Add WindowsUser credentials by using the Credentials Manager (credmgr.exe or credmgrui.exe). For more information about the Credentials Manager, see Pega Robotic Automation Credentials Manager utility.
  8. Add RegistrationOperator credentials by using the Credentials Manager.
  9. Start the Pega RPA Service.
Note: The install folder contains the default version of the RPAService.config file. You must manually move this file to the %ProgramData%\OpenSpan folder.

For more information on the configuration files discussed in this topic, see Main Robotic Automation Configuration Files.

For information on how to use the Pega RPA Service to schedule when Robot Runtime can run RPA robots, see Scheduling when a Robotic Process Automation robot runs.

Did you find this content helpful? YesNo

100% found this useful

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us