Skip to main content

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

Restarting Runtime after connecting to a specific network in Windows

Updated on October 1, 2020

In a Workforce Intelligence implementation, if you have users who log in by using a Virtual Private Network (VPN), you can use Microsoft Task Scheduler to define when a successful network connection starts Pega Robot Runtime.

Note: This article explains how to use configure startup for any VPN. If your company uses the Cisco AnyConnect VPN, refer to Starting Runtime on a Cisco VPN Agent.

The following steps describe how to use the Microsoft Task Scheduler wizard to automatically start Pega Robot Runtime.

  1. From the Windows Start menu, right-click and select Search.
  2. In the Search field, enter Task Scheduler, and then click the Task Scheduler icon.
  3. Click Task Scheduler Library.
  4. Right-click Task Scheduler Library, and then click Create Task.
    "Task Scheduler"
    Create task in Task Scheduler
  5. On the General tab, in the Name field, enter a name for the task, such as Pega Robot Runtime Restart
    "General tab for Create Task"
    General tab for Create Task
  6. Click the Triggers tab.
  7. Click New.
  8. In the New Trigger window, complete the following fields:
    • In the Begin the task field, select On an event.
    • In the Log list, select Microsoft-Windows-NetworkProfile/Operational.
    • In the Source list, select NetworkProfile.
    • In the Event ID field, enter 10000
    • Select the Enabled checkbox at the bottom of the window, and then click OKWhen the VPN agent establishes a successful connection, the system triggers event 10000.
      "New Trigger window"
      New Trigger window
  9. In the Create Task window, click the Actions tab.
  10. Click New.
  11. In the New Action window, complete the following fields:
    • In the Action list, select Start a program.
    • In the Program/script field, enter taskkill
    • In the Add arguments (optional) field, enter /f /im "OpenSpan.Runtime.exe".
    • Click OK.
      "New action"
      New Action window for taskkill
  12. In the Create Task window, on the Actions tab, click New.
  13. In the New Action window, from the Action list, select Start a program.
  14. In the Program/Script field, enter the path to the OpenSpan.Runtime.exe file, depending on your Robot Runtime version.
    • Robot Runtime 19.1
      • For a 64-bit environment, the default location is:
        "C:\Program Files (x86)\Pegasystems\Pega Synchronization Engine\Pega.Loader.exe"
      • For a 32-bit environment, the default location is:
        "C:\Program Files\Pegasystems\Pega Synchronization Engine\Pega.Loader.exe"
    • Robot Runtime 8.0 SP1 
      • For a 64-bit environment, the default location is:
        C:\Program Files (x86)\OpenSpan\OpenSpan Runtime Enterprise\OpenSpan.Runtime.exe
      • For a 32-bit environment, the default location is:
        C:\Program Files\OpenSpan\OpenSpan Runtime Enterprise\OpenSpan.Runtime.exe
  15. For Robot Runtime 19.1 only, in the Add Arguments field, enter the following argument:
    -p Runtime -e OpenSpan.Runtime.exe --noSplash 
    "New Action window to start Runtime"
    New Action window to start Runtime
  16. Click OK.
  17. Verify that the information is correct, and then click OK.
  18. In the Create Task window, click the Conditions tab. 
  19. Clear the Start the task only if the computer is on AC power checkbox.
  20. Select the Start only if the following network connection is available checkbox.
  21. In the list, select the network or SSID so that the scheduled task triggers when the user connects to the specific network. 
    "Conditions tab for Create Task"
    Conditions tab for Create Task
  22. Click OK.

The created task restarts Pega Robot Runtime after successful connection to the Windows network that you select.

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