Citrix Usb Monitor Driver

Applicable Products

Generic USB redirection can be used together with optimized support. If you enable generic USB redirection, configure Citrix USB devices policy settings for both generic USB redirection and optimized support. The Citrix policy setting Client USB device optimization rules is a specific setting for generic USB redirection, for a particular USB. Generic USB redirection can be used together with optimized support. If you enable generic USB redirection, configure Citrix USB devices policy settings for both generic USB redirection and optimized support. The Citrix policy setting Client USB device optimization rules is a specific setting for generic USB redirection, for a particular USB.

Citrix
  • XenDesktop
  • XenApp 6.5
  • XenApp 6.0 for Windows Server 2008 R2
  • XenApp 5.0 for Windows Server 2008
  • XenApp 7.5

Information

This article contains information about USB Support in XenApp.

USB Support in XenApp/XenDesktop

Citrix support for peripherals attached to a client device is a fundamental functionality leveraged by the Citrix Server Based Computing (SBC) model. Support for many client-side peripherals exists. Therefore, when either using local or remotely published applications, end-users can seamlessly utilize their peripheral device resources.

Client-side peripherals are supported in one of two basic methods:
  • Device Level Redirection – This method involves redirection (also called “mapping”) of the high-level device as recognized by the operating system, such as keyboards, mice, or printers. Such devices are not detected by the operating system by the hardware ports to which they connect, but rather by the device itself. For example, whether a keyboard has a USB or Serial port connector, or a printer has a Parallel, Serial, or USB connector, they are detected by the operating system as keyboards and printers. In the latter scenario that is for a parallel printer, the printer mapping functionality is used; LPT port redirection, which is described in the following section, does not play a role.

  • Port Level Redirection – This method involves redirection of the low-level port itself. This includes COM, LPT, and USB ports. These ports are generically identified as ports by the operating system and traffic to them is redirected between server and client. XenApp versions earlier than 7.6 supports the generic redirection of only COM and LPT ports on the client device. Generic redirection of USB port is supported XenApp 7.6 and later. Refer to Generic USB Redirection in XenApp 7.6.

Usb Many USB peripheral devices are supported by the Device Level Redirection method described previously. The following is a general list of the types of USB devices that are supported:

  • USB Keyboards

  • USB Mice

  • USB Printers

  • USB Bar Code Scanners (which emulate keystroke entries)

  • USB Smart Card Readers

  • USB Storage Solutions (such as external drives and memory sticks)

The following USB device types are not currently supported running over a connection. Note that the device are usually configured to operate with a local application on the client device and after the data is captured to transfer the data file to the server by using the normal client drive mapping functionality of XenApp/XenDesktop.

  • USB Image Scanners (such as flatbed scanners)

  • USB Cameras

  • USB Card Readers (such as for credit cards)

  • USB Check Readers

  • USB PDA Cradles

USB Port Level Redirection

Citrix does not support USB devices that require low-level port redirection. Because of the large number of USB-based devices that are available and the proprietary nature of each manufacturer implementation of USB, it has not been possible to date to make a generic USB port redirection solution available as a standard part of the product. Citrix is, however, investigating the possibilities for creating USB solutions for particular devices at the high-level device redirection as previously described. Contact Citrix Systems for the possibility of creating customized solutions for such products, or for information on future support for them within the standard product.

USB Drivers and ICA Clients

Note that all of the USB peripheral support above assumes the existence of a proper USB device driver for the operating system on the client device, and for a corresponding Citrix ICA Client for that same operating system that supports the mapping functionality at hand. For example, not all Citrix ICA clients support the use of smart cards whether or not a device driver from the manufacturer exists.

USB Printers on Macintosh Computers

The Citrix ICA Client for Macintosh OS provides general support for printers attached by using Macintosh USB ports. Some manufacturers supply printer drivers that allow a print file to be sent directly to specific USB printers. Another alternative is to print by using a network print server, instead of using the Client Printer Mapping functionality in the ICA Client. Refer to Citrix Documentation - Mac Printing to Map client devices.

USB Printers on Windows Based Terminals

USB support for Windows Based Terminal client devices is vendor dependent. Contact the Windows Based Terminal vendor for the latest information about USB solutions for their devices.

Additional Resources

  • CTX129558 - How to Redirect USB Devices in XenDesktop
  • CTX137939 - Citrix Generic USB Redirection Configuration Guide
  • Citrix Documentation - VM Hosted Apps
  • Citrix Documentation - Configuring USB Support

Usb Monitor Lcd

Additional Resources


Objective

Citrix Usb Monitor Driver

This article describes how to determine USB drivers are configured correctly on the Online Plug-in.

Background

After installing the Online plug-in, the USB drivers must be loaded in the operating system so that a local USB device appears when connecting to a Virtual Desktop session.

Instructions

  1. Using the WinObj tool from sysinternals, you must see an entry under DeviceCtxUsbMonitor. If the ctxusbm is not present, the device driver has not loaded.

  2. Run the following command at the command prompt to verify that the Citrix USB driver files are located in the correct directory in the file system:

    dir %Windir%ctxusbm.sys /s/b

  3. Run the following command to determine if the USB driver service shows any errors:

    c: >sc query ctxusbm

  4. If the USB driver is not loaded and running, you will need to determine what is causing the service from not installing or stopping it from starting.

    • The setupapi logs will determine if any errors occur during the installation of the driver. The logs are located in the directory under %windir%inf:

    • Verify any errors in the event viewer.

    • If no errors appear, you must uninstall then reinstall the online plug-in with setupapi logging set to the maximum verbosity:
      HKEY_LOCAL_MACHINESoftwareMicrosoftWindowsCurrentVersionSetupLogLevel
      To 0x00007070

Additional Resources

CTX120269 - CDF Tracing for the Desktop Receiver 11.x and 12.x Client for XenDesktop 3.x and 4.x

Disclaimer

The above mentioned sample code is provided to you as is with no representations, warranties or conditions of any kind. You may use, modify and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the sample code may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the sample code fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the sample code. In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities. NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SAMPLE CODE, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Although the copyright in the code belongs to Citrix, any distribution of the code should include only your own standard copyright attribution, and not that of Citrix. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.