Deploying and Optimizing HDX USB Redirection in XenDesktop 5.5

Ramon Scott Lead Escalation EngineerMay 8, 2012

#CitrixSummit

Tweet about this session with hashtag #SUM306 and #CitrixSummit

#CitrixSummit

Presentation Goals

3

Review The Feature

Instruct On How To Configure

Provide Troubleshooting Resources

#CitrixSummit

Agenda

• Overview of the USB Technology

• Feature Components

• Deployment Checklist

• Configuring USB redirection

• Troubleshooting USB redirection

• Optimization

• Case study: USB redirection of Imaging Device

#CitrixSummit

10110110 ICA 10110110 ICA 10110110 ICA 1011011010110110 ICA 10110110 ICA 10110110 ICA 10110110

VirtualChannels

VirtualChannels

USB Overview

Receiver VDA

#CitrixSummit

How Do We Redirect Devices ?

10110110 ICA 10110110 ICA 10110110 ICA 10110110 ICA 1011011010110110 ICA 10110110 ICA 10110110 ICA 10110110 ICA 10110110

#CitrixSummit

How are devices categorized?

• Descriptors

○ Vendor ID, Product ID, Class ,Subclass ,etc

• Classes

○ Mass Storage, Image, HID etc.

Feature Components

#CitrixSummit

Feature Components

Deployment Checklist

Citrix Receiver Polices Configured

HDX Policies Configured in the Console

Verified Device is not Redirected natively

Verified Conflicting Polices are disabled

Verified Software supports redirection method

CONFIGURING USB REDIRECTION

What are the Five Core questions ?

1. How should the Receiver handle existing devices?

2. How should the Receiver handle new devices?

3. Should we list USB devices in the Desktop Viewer?

4. What devices types should be redirected automatically ?

5. What devices are allowed or blocked ?

Receiver Configuration: Desktop ToolBar GUI

Receiver Configuration: Desktop Toolbar GUI

#CitrixSummit

Receiver Configuration: Citrix Connection Center

Receiver Configuration: Computer Policy ADM Template

USB Device Classes Allowed by Default

Different classes of USB device are allowed by the default USB policy rules:

○ Audio (Class 01)

○ Physical Interface Devices(Class 05)

○ Still Imaging (Class 06)

○ Printers (Class 07)

○ Mass Storage (Class 08)

○ Content Security (Class 0d)

○ Video (Class 0e)

○ Personal Healthcare (Class 0f)

○ Application and Vendor Specific (Classes fe and ff)

USB Device Classes Denied by Default

Different classes of USB device are denied by the default USB policy rules:

○ Communications and CDC Control (Classes 02 and 0a)

○ Human Interface Devices (Class 03)

○ USB Hubs (Class 09)

○ Smart Card (Class 0b)

○ Wireless Controller (Class e0)

#CitrixSummit

Device Rules

Syntax:

{Allow: | Deny:} followed by any number of

<tag>=<value> qualifiers. Multiple rules should be

separated by semicolons. Comments start at '#'

and continue until a semicolon.

For example 'Allow: VID=1234 PID=5678 #

Comment ; Deny: Class=03'.

Allow: VID = 045E PID = 00F9 # Microsoft USB

Keyboard; Deny: Class = 03 #Deny other HID’s'

Receiver Configuration: User Policy ADM Template

Receiver Configuration:Registry

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\GenericUSBHKEY_LOCAL_MACHINE\SOFTWARE\Policies\Citrix\ICA Client\GenericUSB\Devices\VID091E PID2353 "AutoRedirect"=dword:00000001

• How to Configure Automatic Redirection of USB Devices

○ http://support.citrix.com/article/CTX123015

#CitrixSummit

DSC Console ConfigurationHDX Device Rules

Examples of administrator-defined USB policy rules:Allow: VID=1230 PID=0007 # ANOther Industries, ANOther Flash DriveDeny: Class=08 subclass=05 # Mass StorageTo create a rule that denies all USB devices, use “DENY:” with no other tags.

Troubleshooting USB redirection

Troubleshooting USB redirection

• CdfControl

• HDXMonitor

• DebugView

• UVCView

• Provides a diagnostic conduit to all Citrix binaries.

• Lots of new features, frequently updated

• Now allows remote tracing and XenDesktop log review

• Article: CTX111961

Common Diagnostic Facility (CDF) Tracing

Recommended Modules•Portica_Service_USB•Policy_ICA_VC•PE_Library_CtxCppBase•PE_Service_CtxSvcHost

• Reports real-time status

• Provide Network Performance statistics

• Reports the active USB device rules

• Delivers USB filtered Event log messages

Citrix HDX Monitor

Optimization:Configuring Bandwidth Limits

• Client USB device redirection bandwidth limit

• Client USB device redirection bandwidth limit percent

Optimization:Adjusting Priority of Virtual Channel

How to Change Virtual Channel Priority in XenDesktop 5 - CTX128190

Case study: Redirecting a Scanner [Imaging Device]

Case study:USB redirection of Imaging Device

Background:

•Poof of Concept Pilot in which scanning was a key requirement for the move to

XenDesktop 5.5

•Issues Reported :

Scanning Failed via Twain redirection

Scanning failed via USB Redirection

Case study:USB redirection of Imaging Device

Troubleshooting TWAIN:

•Verified Polices on Server

•Reviewed Generic USB Polices for conflicts

•Reviewed endpoint configuration

○ Removed USB Policies

•Reviewed software used to test

Case study on USB redirection of Imaging Device

Resolution: TWAIN

•Document Process

○ To enable Citrix Twain Policy

○ Deploy correct driver to endpoint

○ Review if software is Twain aware

Case study:USB redirection of Imaging Device

Troubleshooting USB Redirection:

•Verified HDX Polices in Delivery Services Console

•Reviewed Generic USB Polices on endpoint

•Attempt with Basic Configuration

•Reviewed endpoint configuration

○ Removed USB Policies

•Reviewed software used to test

Case study on USB redirection of Imaging Device

Resolution: Generic USB Redirection

•Document Process

○ To disable Citrix Twain Policy

○ Deploy correct driver to VDAs

#CitrixSummit

Resources Covered

•How to Configure Automatic Redirection of USB Devices

•USB Class Codes

•How to Change Virtual Channel Priority in XenDesktop 5

•HDX Monitor

#CitrixSummit

Resources Covered (continued)

•CDF Control

•DebugView

•UVCView

Q&A

#CitrixSummit

We value your feedback!Take a survey of this session now in the mobile app

• Click 'Sessions' button

• Click on today's tab

• Find this session

• Click 'Surveys'

#CitrixSummit

Before you leave…

• Conference surveys are available online at www.citrixsummit.com starting Thursday, May 10○ Provide your feedback and pick up a complimentary gift at the registration desk

• Download presentations starting Monday, May 21, from your My Organizer tool located in your My Account

#CitrixSummit

Presentation Goals: Recap

41

Review The Feature

Instruct On How To Configure

Provide Troubleshooting Resources