Skip to main content

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

Upgrading to Pega Robot Manager 6 for Pega Platform 7.4

Updated on October 8, 2021

Upgrade to Pega Robot Manager™ 6 on Pega Platform™ 7.4 to take advantage of new features such as instant email notification in case of issues, ability to start, stop, terminate and schedule robots from the Pega Robot Manager interface. For a complete list of new features, see Pega Robot Manager 6.


  1. Back up your application files, and Pega Platform, in case you need to restore your system.
  2. Make sure that you are using Pega version 8.0 SP1 2019 or later of Pega Robotic Automation™. For best results, use 8.0 SP1 2025 or later.
  3. Install Pega Platform 7.4, and then verify your installation as described in the Platform Installation Guide for your environment, available on the Deployment guides page.
  4. Apply the following hotfixes:
    1. HFIX-48994
    2. HFIX-48786
    3. HFIX-52196
    For more information, see Obtaining hotfixes.
  5. If you previously customized dynamic system settings related to Pega Robot Manager, note them down so that you can restore them after upgrading. To view the current dynamic system settings, perform the following actions:
    1. In Designer Studio, click Records > SysAdmin > Dynamic System Settings.
    2. Filter by Owning Ruleset Pega-Robotic-AutomationPackageManagement.

Upgrade procedure

To upgrade to Pega Robot Manager 6, perform the following steps:

  1. Download Pega Robot Manager 6 from the Pega Robot Manager Marketplace page.
  2. Extract the files from the file.
  3. Import the Pega Robot Manager application bundle into Pega Platform:
    1. Log in to Pega Platform by using the administrator ID that you set up when you installed Pega Platform (for example, [email protected]) and the password that you specified.

      The default Pega Platform address is https://<hostname>:<port>/prweb

    2. Open the Import Wizard by clicking Designer Studio > Application > Distribution > Import.
    3. Depending on your browser, click Choose file or Browse, browse to the location where you extracted the file, open the 7.4\Rules\PegaRobotManager_<version>_74.jar file, and then click Next.

      Example: For Pega Robot Manager 6 the relative file path is 7.4\Rules\PegaRobotManager_V6_74.jar, for Pega Robot Manager 6.1 7.4\Rules\PegaRobotManager_V61_74.jar, and for Pega Robot Manager 6.2 7.4\Rules\PegaRobotManager_V62_74.jar

    4. Select Enable advanced mode to provide more granular control over the import process, and then click Next.
    5. To preserve existing operators, do not select the Enable new operators and overwrite existing operators on import check box.
    6. Click Next and finish the upgrade process.
  4. If you are upgrading Pega Robot Manager from releases earlier than version 5, run the pxMigrateRobotLogEntriesToV5 activity to upgrade rendering of the following pages and widgets:
    • Robots > Work groups and Robots > Robots pages (Previously located under Work groups and Users > Robots)
    • The page that is displayed when you click a robot
    • The page that is displayed when you click an assignment type
    • The Robot status and Automation alerts over time widgets
    Perform the following actions:
    1. In Designer Studio, search for pxMigrateRobotLogEntriesToV5.
    2. In the search results, click the pxMigrateRobotLogEntriesToV5 activity to open it.
    3. Click Actions > Run.
      Depending on the volume of historical robotic process automation audit data in your database, this activity might take some time to complete.

Adding Pega Robot Manager to an existing application that uses a UIKit version earlier than 11.01

​If you have an existing Pega Platform application that uses a version of the UIKit earlier than 11.01 , you can add Pega Robot Manager to your application by completing the following steps:

  1. Log in to Designer Studio as an administrator of your existing application.
  2. Open the application record:
    1. In the navigation panel of Designer Studio, click Records.
    2. Expand the Application Definition category, and then click Application.
    3. Click your application.
  3. In the Edit Application form, in the Built on application(s) section, add UIKit 11.01 to the application stack:
    1. Click Add application.
    2. In the Name field, press the Down Arrow key and select UIKit.
    3. In the Version field, press the Down Arrow key and select 11.01.
  4. Add your PegaRoboticAutomationConsole to your application stack:
    1. In the same Edit Application form, in the Built on application(s) section, click Add Application.
    2. In the Name field, press the Down Arrow key and select PegaRoboticAutomationConsole.
    3. In the Version field, press the Down Arrow key and select 03.01.01.
  5. Click Save.
  6. Create an access group that points to the PegaRobotAutomationConsole application:
    1. Click +Create > Security > Access Group.
    2. Enter a name and description, and then click Create and Open.
    3. In the Application section, in the Name field, enter PegaRoboticAutomationConsole.
    4. In the Version field, enter 02.02.01.
    5. In the Available portals section of the access group, add pyRoboticConsole to the list of portals.
    6. On the Advanced tab of the access group, add the default work pool of your existing built-on application.
    7. Click Save in the Edit Access Group form.
  7. Assign the new access group to your users. For more information, see Profile tab on the Operator ID form.

Changes to dynamic system settings

Note: The default setting for WorkgroupSpecifiedInPayloadTakesPrecedence dynamic system setting was changed from "true" to "false".

The following dynamic system settings were added in Pega Robot Manager 6:

  • AllowedWaitTimeForRobotRegistration - specifies the maximum expected time that the RPA Service should take to start up the robot runtime system. It includes the time to unlock the remote machine, and start the runtime process. Default value: 120 seconds.
  • MaxStartsIssuedPerScheduleAction - prevents Pega Robot Manager from continuously attempting to restart a robot that has failed to start during one Scheduled action or Otherwise event. Pega Robot Manager will check this value before attempting to start a robot. If the number of start attempts is less than the number provided, the start will be issued. Default value: 4
  • ServiceOperatorHeartbeatInterval - defines how often the RPA Service should send a heartbeat signal to Pega Robot Manager. When the RPA Service does not send a heartbeat within this interval, it is assumed to be not running. When the RPA Service is not running, UI options (such as Start a robot and Terminate a robot) are not available from Pega Robot Manager. Default value: 45 seconds.
  • TimeoutIntervalForRobotCommandToBeCompleted - determines the time-out interval for the start command issued to robots in conjunction with the RPA Service heartbeat interval. Default value: 30 seconds.

Changes to decision tables

The following decision tables were added in Pega Robot Manager 6:

  • pyGetWorkGroupbyRobotID - allows robots to register to their base work groups based on robot ID.
  • pyGetCandidateWorkGroupListByDispatchOperator - maps the ID of the administrative operator to a comma-separated list of work groups. All the robots registered by a specific operator can be moved between the specified candidate work groups. The move command can be issued by a user or by a schedule. Note: The list of candidate work groups must contain the robot's base work group.
  • pyGetThresholdByNotificationType - allows Pega Robot Manager 6 users to change the default conditions for triggering a notification. For more information, see Configuring notifications.

Changes to agents

Note: All agents must have their Access group set to PegaRoboticConsole:Administrators. For more information about setting Access groups, see Profile tab on the Operator ID form.

The following Agents were added in Pega Robot Manager 6:

  • MonitorRobotCommandAndHeartbeat - checks the status of robots and the RPA Service - if the RPA Service and robot send a heartbeat signal regularly, and if robots react appropriately when they are issued commands such as start or stop. The status of robots displayed in Pega Robot Manager is updated based on the actions of this agent. By default, the check is performed every 30 seconds; this is the recommended value, because a longer interval will delay notifying the user about issues such as a time-out.
  • ProcessRobotScheduleActions - checks for the schedule that is set on a robot and executes the defined schedule. The check is performed every 300 seconds, which is the recommended value. Note: The ProcessRobotScheduleActions agent must be run in a Periodic pattern on a single node. For more information, see Agents rules – Completing the Schedule tab.
  • NotifyRobotSchedulingAgentTermination - checks the status of the ProcessRobotScheduleActions agent and notifies the user if it is down. The check is performed every 1800 seconds, which is the recommended value. Note: In multinode environments, the NotifyRobotSchedulingAgentTermination agent must run on the same node as ProcessRobotScheduleActions agent.

Changes to pyCompleteAutomation flow action

In previous versions of Pega Robot Manager, the pyCompleteAutomation flow action had no default behavior defined, and it was not marked as an Extension. In Pega Robot Manager 6, this flow action is marked as an Extension, and its default behavior is to consider the automation status as "Complete" and move the flow to the next stage of the case life cycle.

Note: It is strongly recommended to customize the default behavior of pyCompleteAutomation flow action to better suit the needs of your organization.

Configuring email notifications

Pega Robot Manager 6 supports notifying users by email in case of unexpected behavior or errors. To use this feature, perform the following steps:

  1. Configure an email account that will be used to send the notifications. For more information, see Creating an email account.
  2. Set the Public Link URL to the following format: http://<host>/prweb/PRServlet. For more information, see System Settings – Resource URLs tab.

What to do next

For further technical details about Pega Robot Manager 6, see Configuring Pega Robot Manager 6.

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us