Skip to main content

Starting Runtime on a Cisco VPN agent

Suggest edit Updated on October 2, 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 Cisco AnyConnect VPN agent starts Pega Robot Runtime.

Note: This article explains how to configure startup with a Cisco AnyConnect VPN. If your company uses a different solution, refer to Restarting Runtime after connecting to a specific network in Windows.

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, type Task Scheduler, and then click the Task Scheduler icon.
  3. Click Task Scheduler Library.
  4. Right-click the Task Scheduler Library, and then click Create Basic Task.
  5. In the Create Basic Task Wizard, in the Name field, enter a name for the task, and then click Next.
  6. Optional: In the Description field, enter a description of the task, and then click Next.
  7. On the Task Trigger panel, choose When a specific event is logged and click Next.
  8. In the When a Specific Event is Logged pane, complete the following fields:
    • In the Log field, select Cisco AnyConnect Secure Mobility Client.
    • In the Source field, select acvpnagent.
    • In the Event ID field, type 2039.
  9. Click Next. When the Cisco AnyConnect VPN agent establishes a successful connection, the system triggers event 2039.
  10. On the Action panel, select Start a Program and click Next.
  11. 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
  12. For Robot Runtime 19.1 only, in the Add Arguments field, enter the following argument:
    -p Runtime -e OpenSpan.Runtime.exe --noSplash 
  13. Click Next.
  14. Verify that the information is correct, and then click Finish.

The Cisco AnyConnect VPN agent is now set up to start Pega Robot Runtime.

In case of a connection failure

If you start Robot Runtime and then lose the VPN connection, the system automatically reconnects. After the system reconnects, the Cisco AnyConnect VPN agent runs this task again and attempts to start Robot Runtime. The following error message is displayed:

Runtime is already running

To ignore this error, click Ok.

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