Skip to main content

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

Adding the Pega Loader program on the Citrix server

Updated on October 19, 2022

Use the Pega Loader program to start Robot Runtime on your Citrix server. On the Citrix client, Robot Runtime passes information to the published virtual application (Pega.Loader.exe). The Pega Synchronization Engine uses this information to ensure that the correct verson of Robot Runtime is installed on the Citrix server.

Before you begin: To use the Pega Synchronization Engine in a Citrix mixed-mode environment, ensure that your Citrix server can connect to the Pega Synchronization Server.
  1. In Windows, start Citrix Studio.
  2. In the Citrix Studio window, select Delivery Groups.
  3. In the Actions pane, click Add Applications.
  4. In the Create Application dialog box, click Next.
  5. In the list of applications, click Add applications manually.
  6. In the Add Applications Manually dialog box, in the Path to executable file field, click Browse.
  7. In the Choose share dialog box, select the share that you want to browse, and then click Continue.
    Choose share dialog box
    Choose the share to browse.
  8. In the Open dialog box, browse to the Pega.Loader installation folder.
    The installation folder is typically located at: ...\Program Files (x86)\Pegasystems\Pega Synchronization Engine.
  9. Select the Pega.Loader.exe program and then click Open.
  10. In the Add Applications Manually dialog box, in the Command line argument (optional) field, enter a percent sign and two asterisks (%**).For example:
    C:\Program Files (x86)\Pegasystems\Pega Synchronization Engine\Pega.Loader.exe” %**
    This command allows the ICA client to pass arguments to Robot Runtime when it launches. There are additional configuration screens that contain options such as color depth, which Citrix server to run on, and so on. Refer to the Citrix documentation for information about these fields.
  11. In the Application name (for user) field, enter Pega.Loader.
  12. In the Application name (for administrator) field, enter Pega Robot Runtime, and then click OK.
    Add Applications Manually dialog box
    Adding the Robot Runtime application.
  13. In the Create Applications dialog box, click Next.
  14. In the Summary dialog box, click Finish.
  15. In the Citrix Studio window, click the Application tab.
  16. Highlight Pega Robot Runtime and confirm the application setup on the Details tab.
    Details tab
    A typical configuration on the Application Details tab.
    Note: For solutions that have groups of users with varying Published Application names, you can use environment overrides to set custom values for properties such as the Published Application based on the deployed environment (for example: "Group1", "Group2", "Group3").

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