ThinLinX Support > ThinLinX Help Desk > Knowledgebase

Search help:

USB redirection in HDX mode


Citrix Workspace App has a default policy that is pretty good at anticipating typical USB redirection requirements, and you will rarely need to alter this.  At present ThinLinX UIs (TMS and Tlxconfig) don't support any "Redirect USB" option other than "Auto", but in future we will add "Auto with allow overrides" and "Auto with deny overrides" options to enable minor alterations to the default policy.

Typically, the only situation in which you will need to alter the client-side HDX USB redirection policy is when your USB device presents as a compound USB device, i.e. contains several subdevices, some of which are blocked by the default policy.  For example, many smart phones have HID devices that the default policy will block.  On the Raspberry Pi platform you may also need to alter the policy relating to USB audio devices, because the ARM port of RTME is not yet available (to ThinLinX, anyway).

The Workspace App USB redirection policy file is located in /opt/Citrix/ICAClient/usb.conf.  This is used by the ctxusbd daemon (and systemd service of the same name).  The default policy basically blocks mice, keyboards, USB hubs, audio devices, modems, smartcard readers, and some (but not all) WiFi and USB ethernet devices, and allows everything else.

In order to override the default policy for a particular USB device, you need to add an ALLOW line to the /opt/Citrix/ICAClient/usb.conf file, above the first of the DENY lines, for the specific USB vendor and product ID of your device.  You can obtain these by opening a local terminal window and entering "lsusb".  For example, an ALLOW line for an iPhone 4S would look like:

ALLOW: vid=05ac, pid=12a0

To do this, you will need to SSH as root to your TLXOS device (see separate knowledgebase article on this subject).  Run "systemctl restart ctxusbd" after making the change.

Related articles Default USB redirection policies
Webcam / USB headset redirection problems on Raspberry Pi
CUPS printer redirection (using Citrix Universal Print Driver) isn't working!
Serial port redirection in RDP mode
Article details
Article ID: 18
Category: Workarounds for Old Versions
Date added: 2019-05-29 03:04:17
Views: 533

« Go back