Troubleshooting VDI plugin installation

The following information can help you troubleshoot and resolve common issues with Citrix Receiver, Omnissa Horizon Client, or Azure Virtual Desktop (AVD). This article can also help you confirm the reason installation may not work for some users.

Table of Contents

How to troubleshoot common issues with Citrix Receiver, Omnissa Horizon Client, and AVD Plugin

Applications still running error

Issue: You receive a dialog box from the Zoom Plugin for Citrix Receiver/Omnissa Horizon Client with the error message: Citrix Receiver/Omnissa Horizon Client is running. Please close it to continue to install the Zoom Plugin for Citrix Receiver/Omnissa Horizon Client. A possible cause for this issue is that Citrix Receiver or Omnissa Horizon Client is still running during the installation.

Suggestions:

Installation due to a different version error

Issue: The installation of a different version does not work. In standard (not quiet mode) installation, you receive a dialog box from the Zoom Plugin for Citrix Receiver/Omnissa Horizon Client with the error message: Unable to install because a newer version of the product is already installed.

Suggestions:

Troubleshoot Citrix Workspace/Receiver

Confirm Citrix Workspace/Receiver installation

Our installer requires an existing install folder of Citrix Workspace/Receiver on the system because our binary files must be directly copied into this folder.
Note: Ensure that the Workspace/Receiver is installed on the system and is not a UWP/Microsoft Store version. For more information about the differences between versions, see How to Detect Citrix Receiver for Windows Edition (Store or Manual Install).

Check if the installer successfully copied files

By default, Zoom Citrix plugin binaries are copied to the installation directory below:

To confirm if the plugin installation was successful:

  1. Under the above install folder, check all binary files (files ending in .dll and .exe) to see if the dates under the Date Modified column are more or less than a few hours apart (versus days, for example).
  2. If the dates are more than a few days apart, there could have been a corrupted installation or manually modified files by a user (which will require uninstall/reinstall to fix).

Files under ZoomVDIUniversalPlugin\Plugin and ZoomVDIUniversalPlugin\x64 contain plugin files (ZoomMedia.dll) and should have a similar Date Modified column to the files in the parent folder. These files must be copied to the Citrix Receiver installation path, which is found by checking the registry key value InstallFolder under HKLM or HKCU\SOFTWARE\Citrix\Install\ICA Client.

Alternatively, while Citrix Receiver is running, you can get the install path by using Task Manager:

  1. Press the Ctrl + Alt + Delete keys to open Task Manager.
  2. Click the Details tab.
  3. Find wfica32.exe.
  4. Right-click wfica32.exe and select Open File Location from the dropdown menu.

Check plugin registration

To confirm plugin registration, launch Registry Editor (regedit.exe). Ensure that the following registry key paths and values display the following data below:

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0]
"VirtualDriverEx"="ZoomCitrixMediaPlugin"

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ZoomCitrixMediaPlugin]
"DriverName"="ZoomMedia.dll"
"DriverNameWin32"="ZoomMedia.dll"
"ZoomPath"="C:\Program Files\ZoomVDIUniversalPlugin\"

Citrix Plugin Connection Failure

Citrix ICA policies include an option to control whether applications are allowed to allocate a virtual channel. Starting with Citrix VDA 2109, the default virtual channel allow list policy changed from Enabled to Disabled. To learn more about this change, please refer to the article Configuring the Citrix virtual channel allow list policy.

Troubleshoot Omnissa Horizon Client

Confirm Omnissa Horizon client installation

Our installer requires the Omnissa Horizon Client to be installed because our binary files must be directly copied into this folder. The installer looks for the Omnissa Horizon install folder path, using the registry key value below.

Ensure that this key exists on the Thin Client and the data for ClientInstallPath points to an existing folder: HKLM\Software\Omnissa\Horizon.

Check if the installer successfully copied files

By default, the Zoom Universal plugin binaries are copied to the installation directory below:

To confirm if the plugin installation was successful:

  1. Under the above install folder, check all binary files (files ending in .dll and .exe) to see if the dates under the Date Modified column are more or less than a few hours apart (versus days, for example).
  2. If the dates are more than a few days apart, there could have been a corrupted installation or manually modified files by a user (which will require uninstall/reinstall to fix).

Files under ZoomVDIUniversalPlugin\Plugin and ZoomVDIUniversalPlugin\x64 contain plugin files (ZoomMedia.dll) and should have a similar Date Modified column to the files in the parent folder. 

Check plugin registration

To confirm plugin registration, launch Registry Editor (regedit.exe). Ensure that the following registry key paths and values display the following data below (default path shown below for example):

[HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\VDPService\Plugins\ZoomMedia]
"dll" = "C:\Program Files\ZoomVDIUniversalPlugin\x64\ZoomMedia.dll"
"ZoomPath"="C:\Program Files\ZoomVDIUniversalPlugin\"

Zoom VDI Plugin Connection Failure

Zoom recommends using Omnissa connection protocols for the Horizon client. Thin clients running Linux may allow specifying PCoIP as the connection protocol for Omnissa Horizon. The version of PCoIP provided with the operating system, however, may not support the virtual channels required to connect to the Zoom VDI Plugin. If the VDI Plugin is not connecting, switch the connection protocol to the Omnissa Blast protocol.

Troubleshoot AVD plugin

To confirm plugin registration, launch Registry Editor (regedit.exe). Ensure that the following registry key paths and values display the following data below (default path shown below for example):

[HKEY_LOCAL_MACHINE\SOFTWARE\Omnissa\Horizon\VDPService\Plugins\ZoomMedia]
"dll" = "C:\Program Files\ZoomVDIUniversalPlugin\x64\ZoomMedia.dll"
"ZoomPath"="C:\Program Files\ZoomVDIUniversalPlugin\"

How to gather installer logs

For further troubleshooting, we may request logs from the plugin or VDI Client installers.

Note: Windows plugins support MSI installer logging.

To gather installer logs:

  1. As an administrator, launch the command prompt and run the following command:
    msiexec /i %MSI_FILE_PATH% /L*V %LOG_FILE_OUTPUT%
  2. Replace the %LOG_FILE_OUTPUT% with a log file name (ending in .txt).
  3. Replace %MSI_FILE_PATH% with the path to the installer. For example:
    msiexec /i ZoomVDIUniversalPluginx64..msi /L*V .\log.txt