20170818 Citrix外設情景和排錯

20170818 Citrix外設情景和排錯
VDA訪問USB設備的兩種方式：
1.    VDA本地訪問USB設備
    使用通用USB映射
    該方式在VDA的設備管理器裏面能夠看到USB設備
2.VDA遠程訪問客戶端設備
    使用HDX優化模式
    在Receiver的設備管理器裏面能夠看到USB設備
    
通常情況下，以下設備支持HDX優化模式，通過HDX虛擬通道實現，只要在客戶端安裝驅動：
顯示器、鼠標、鍵盤、VOIP電話、頭戴式耳機、攝像頭、掃描儀、打印機、磁盤、智能卡讀卡器、繪圖儀、簽字版

1.USB大容量存儲
    通過CDM（Client Drive Mapping）虛擬通道
    設置USB磁盤只讀：
        CDM：DDC策略，Read-only client drive access
        USB:微軟策略，可移動磁盤，Deny write access
    排錯：
        無法在映射的客戶端磁盤上執行可執行文件
            解決方法：在VDA中修改註冊表值HKLM\Software\Citrix\GroupPolicy\Defaults\CDMSettings下ExecuteFromMappedDrive,REG_DWORD,1
        映射的客戶端磁盤文件超過4G
            解決方法：ICA文件系統是32位的，查看官方KB：https://support.citrix.com/article/CTX134844
        
        更多關於CDM排錯：https://support.citrix.com/article/CTX238200
        
2.攝像頭
    通過RAVE虛擬通道
    可在例如Skype、Lync、QQ、AMCAP等使用
    排除：
        默認分辨率352*288
            解決方法：在Receiver端修改註冊表HKCU\Software\Citrix\HdxRealTime下DefaultWidth,REG_DWORD,value1和Defaultheight,REG_DWORD,value2
        VDA端找不到設備
            解決辦法：VDA端查找註冊表HKCR\{Wow6432node\}CLSID\{860BB310-5D01-11d0-BD3B-00A0C911CE86}\Instance\Citrix HDX Web Camera；允許windows media重定向；使用AMCAP測試(支持的程序需要基於Directshow API開發)；收集CDF Traces日誌
        更多信息：https://support.citrix.com/article/CTX132764

3.掃描儀、高拍儀
    通過TWAIN虛擬通道
    DDC策略，客戶端TWAIN設備重定向（默認開啓）
    排錯：
        測試小工具：Twacker
        僅支持Native和Buffer Memory模式，不支持Disk File Transfer模式
    更多信息：https://support.citrix.com/article/CTX1326395    

不支持HDX優化模式的情況下，使用USB重定向模式：
    需要查看VID、PID、Class、SubClass、Prot
    在DDC端設置：開啓USB重定向（默認關閉）    檢測VDA端註冊表：HKLM\Software\Policies\Citrix\<userID>\User\VCPolicies下的AllowUSBRedir和USBDeviceRules
    當在DDC上對同一個交付組設置了多個USB重定向的策略，高優先級的策略生效
    ToolBar上的Device會顯示提示信息
    設置使用通用USB映射：在Receiver端修改註冊表HKLM\Software\(Wow6432node\)Citrix\ICA Client\GenericUSB\DeviceRules
    自動連接USB設備：在ToolBar上連接中勾選；若客戶端設備加入域，則可以通過組策略批量修改：導入組策略icaclient_usb.admx/adml到c:\program files(x86)\citrix\ica client\configuration\en,在經典模板-citrix組件-遠程客戶端設備-通用USB遠程中的現有USB設備和新USB設備中修改對應的值即可
    自動將虛擬通道的設備通過通用USB的方式映射：
    註冊表：HKLM\Software\(Wow6432Node\)citrix\ica client\generic usb\devices中的autoredirectXXX的值
    
    更多信息：https://support.citrix.com/article/CTX123015
    
    XenApp中支持USB映射的情況：
        VDA操作系統的要求：
            Windows Server 2012 R2
            Windows Server 2016
        限制：
            XA7.6中不支持USB設備、聲卡、智能卡讀卡器、其他不能完全虛擬化的設備使用優化模式，只能使用USB映射模式
            XA7.9支持USB設備使用優化模式

常見問題：
    1.ToolBar上無設備選項卡
        解決方法：檢查是否開啓了USB重定向策略
    2.設備上提示策略限制
        解決方法：檢查DDC策略：客戶端USB設備重定向規則；修改註冊表：HKLM\software\(wow6432node\)citrix\ica client\genericusb\devicerules
    3.優化模式無法正常使用
        解決方法：切換到通用USB方式
    4.切換成通用USB方式時報錯，顯示USB設備正在使用
        解決方法：在Receiver端設置EnableForceRestartForHID值爲1；Citrix Receiver4.7+允許強制重定向；停止或卸載設備驅動；收集CDF traces日誌
    5.設備管理器的設備顯示黃色歎號
        解決方法：查看VDA端驅動安裝日誌%windir%\inf\setupapi.dev.log；VDA端收集usblyzer trace日誌；在VDA和終端收集CDF traces日誌
    6.MTP設備無法正常使用
        解決方法：更新驅動程序，選擇便捷設備-MTP USB設備
    7.USB Key設備被smart card hook影響
        解決方法：刪除VDA的註冊表項，32位和64位系統：HKLM\software\citrix\ctxhook\appinit_dlls\smart card hook,64位系統：HKLM\software\wow6432node\citrix\ctxhook\appinit_dlls\smart card hook
        
        
USB設備出現問題時，收集CDF trace日誌方法：
    Receiver端：安裝offlineplugin;修改註冊表：HKLM\system\CurrentControlSet\Services\Cdfdrv值設置爲0並重啓
    Client端：icaclient_genericusb_ctxusbm;icaclient_genericusb_ctxusbr;icaclient_genericusb_vdgusb
    VDA端：Portica_Driver_USB;Portica_Service_USB(Portica_Service_Redirector)
    
COM和LPT設備：
    VDA端修改：
        VDA7.9-：
            COM設備：
                HKLM\software\citrix\GroupPolicy\Defaults\Deprecated添加AllowComPortRedirection,REG_DWORD,1和AutoConnectClientComPorts,REG_DWORD,1
            LPT設備：
                HKLM\software\citrix\GroupPolicy\Defaults\Deprecated添加AllowLptPortRedirection,REG_DWORD,1和AutoConnectClientLptPorts,REG_DWORD,1
                
        VDA7.9+:
            Studio Policy:
                COM設備：客戶端COM口重定向、自動連接客戶端COM口
                LPT設備：客戶端LPT口重定向、自動連接客戶端LPT口
    排錯：
        使用net use查看映射的設備
        調整buffer size：
            修改Receiver端註冊表：HKLM\software\(wow6432node\)citrix\ica client,CommBufferSize 2048(DWORD,decimal)
            HKLM\Software\(wow6432node\)citrix\ica client\engine\configuration\advanced\modules\clientcomm,windowssize 2048(DWORD,decimal)