UiPath Documentation
studio
latest
false
Studio user guide

Troubleshooting

This page explains how to fix issues you might encounter when running automation in Citrix environments.

Virtual channels blocked by default​

Observed behavior​

After upgrading to a Citrix version higher than Citrix Virtual Apps and Desktops 7 2109, existing Citrix automations that rely on UiPath Remote Runtime fail: selector generation stops working and UI Automation activities can no longer detect Citrix elements.

Cause​

Starting with Citrix Virtual Apps and Desktops 7 2109, all custom virtual channels are blocked by default, which prevents UiPath Remote Runtime from communicating with the Citrix session.

Solution​

Add the UiPath virtual channel to the Citrix allow list policy:

  1. Configure the allow list policy by following the Citrix virtual channel allow-list policy settings documentation.

  2. Add the following value to the allow list policy, replacing <UiPathRemoteRuntime-Install_Path> with your install location:

    UIPCTX,<UiPathRemoteRuntime-Install_Path>\UiPathRemoteRuntime.exe

    For example:

    UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe

Interactive selection in Citrix apps freezes and nothing is selected​

Observed behavior​

After you install the UiPath Extension for Citrix and try to select UI elements from a Citrix App, interactive selection freezes for one minute, and then nothing is selected.

Cause​

This happens if the UiPath Remote Runtime is not running in the Citrix App session.

Solution​

  • Check if the UiPathRemoteRuntime.msi is installed on the Citrix application server from which the Citrix App is opened.

  • On the Citrix application server, check if the UiPathRemoteRuntime.exe process is running. If the UiPathRemoteRuntime.msi is installed, then the process is started automatically on the Citrix App session login.

    Note:

    If you cannot install UiPathRemoteRuntime.msi on the Citrix application servers, consider uninstalling the UiPath Extension for Citrix from the client machine. For instructions, see Extension for Citrix.

Could not copy over file "C:\Program Files (x86)\Citrix\ICA Client\UIPathPluginCitrix.dll". It is being used by another process.​

Observed behavior​

When you try to install the UiPath Extension for Citrix, the following error is displayed:

Cause​

This occurs when the UiPath Extension for Citrix is already installed and an open Citrix App is using it.

Solution​

Close all active Citrix App sessions, as described in Restarting active Citrix sessions, then reinstall the UiPath Extension for Citrix.

Could not read Citrix registry key: 'SOFTWARECitrixInstallICA Client' Value: 'InstallFolder'​

Observed behavior​

When you try to install the UiPath Extension for Citrix, the following error is displayed:

Cause​

This error message is displayed when the Citrix Receiver is not installed. It is also displayed if the Citrix Receiver for Universal Windows Platform is installed.

Solution​

Download and install the Citrix Receiver or Citrix Workspace.

Unhandled exception in Wfica32.exe 0xC0000094: Integer division by zero​

Observed behavior​

Target Citrix App fails to launch and the Citrix ICA client crashes.

Cause​

Activities which use the GetWindowText function (such as Element Exists) are executed before the Citrix App can load.

Solution​

Allow time for the Citrix App to load by adding a delay before the activity.

Interactive selection and element identification does not work with high DPI​

Observed behavior​

Starting with Citrix Workspace App (CWA) for Windows 2206, if no High DPI policy settings are applied, interactive selection and element identification might not work for Citrix Apps when the display DPI scaling is higher than 100%.

Cause​

This is caused by the following change in Citrix: DPI support changes with Citrix Workspace App for Windows 2206.

Solution​

Delete the Enable_DPI registry value from Computer\HKEY_CURRENT_USER\SOFTWARE\Citrix\ICA Client\DPI:

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated