USBリダイレクトの構成
USBデバイスは、Citrix Workspace™アプリとLinux VDAデスクトップ間で共有されます。USBデバイスがデスクトップにリダイレクトされると、ローカルに接続されているかのようにUSBデバイスを使用できます。
ヒント:
ネットワーク遅延が100ミリ秒未満の場合は、USBリダイレクトを使用することをお勧めします。ネットワーク遅延が200ミリ秒を超える場合は、USBリダイレクトを使用しないでください。
USBリダイレクトには、主に次の3つの機能領域があります。
-
オープンソースプロジェクトの実装（VHCI）
-
VHCIサービス
-
USBサービス
オープンソースVHCI:
USBリダイレクト機能のこの部分は、IPネットワークを介した汎用USBデバイス共有システムを開発します。これは、Linuxカーネルドライバーと、カーネルドライバーと通信してすべてのUSBデータを取得できるいくつかのユーザーモードライブラリで構成されています。Linux VDAの実装では、CitrixはVHCIのカーネルドライバーを再利用します。ただし、Linux VDAとCitrix Workspaceアプリ間のすべてのUSBデータ転送は、Citrix ICA®プロトコルパッケージにカプセル化されます。
VHCIサービス:
VHCIサービスは、VHCIカーネルモジュールと通信するためにCitrixが提供するオープンソースサービスです。このサービスは、VHCIとCitrix USBサービス間のゲートウェイとして機能します。
USBサービス:
USBサービスは、USBデバイス上のすべての仮想化とデータ転送を管理するCitrixモジュールとして機能します。
USBリダイレクトの仕組み
通常、USBデバイスがLinux VDAに正常にリダイレクトされると、システム/devパスに1つ以上のデバイスノードが作成されます。ただし、リダイレクトされたデバイスがアクティブなLinux VDAセッションで使用できない場合があります。USBデバイスは、正常に機能するためにドライバーに依存しており、一部のデバイスは特別なドライバーを必要とします。ドライバーが提供されていない場合、リダイレクトされたUSBデバイスはアクティブなLinux VDAセッションからアクセスできません。USBデバイスの接続性を確保するには、ドライバーをインストールし、システムを適切に構成してください。
Linux VDA は、クライアントとの間で正常にリダイレクトされる USB デバイスのリストをサポートしています。
サポートされている USB デバイス
以下のデバイスは、このバージョンの Linux VDA をサポートすることが確認されています。その他のデバイスも自由に使用できますが、予期しない結果が生じる可能性があります。
注:
Linux VDA は USB 2.0 プロトコルのみをサポートしています。
| USB マスストレージデバイス | VID:PID | ファイルシステム |
|---|---|---|
Netac Technology Co., Ltd |
0dd8:173c | FAT32 |
Kingston Datatraveler 101 II |
0951:1625 | FAT32 |
Kingston Datatraveler GT101 G2 |
1567:8902 | FAT32 |
SanDisk SDCZ80 flash drive |
0781:5580 | FAT32 |
WD HDD |
1058:10B8 | FAT32 |
| USB 3Dマウス | VID:PID |
|---|---|
3DConnexion SpaceMouse Pro |
046d: c62b |
| USBスキャナー | VID:PID |
|---|---|
Epson Perfection V330 photo |
04B8: 0142 |
USBリダイレクトの構成
Citrixポリシーは、USBデバイスリダイレクトを有効にするか無効にするかを制御します。デバイスの種類は、Delivery Controller™ポリシーを使用して指定することもできます。Linux VDAのUSBリダイレクトを構成する場合は、次のポリシーとルールを構成します。
-
クライアントUSBデバイスリダイレクトポリシー
-
クライアントUSBデバイスリダイレクト規則
USBリダイレクトを有効にする
Citrix Studioで、クライアントとの間でUSBデバイスリダイレクトを有効（または無効）にします（ワークステーションホストのみ）。
設定の編集ダイアログで、:
-
許可を選択します。
-
OKをクリックします。
VHCIカーネルモジュールをビルドする
USBリダイレクトは、VHCIカーネルモジュール（
usb-vhci-hcd.koおよびusb-vhci-iocif.ko）に依存します。これらのモジュールは、Linux VDAディストリビューションの一部（RPMパッケージの一部）です。これらは公式のLinuxディストリビューションカーネルに基づいてコンパイルされており、次の表に示されています。
| サポートされるLinuxディストリビューション | カーネルバージョン |
|---|---|
| RHEL 8.3 | 4.18.0-240 |
| RHEL 8.2 | 4.18.0-240 |
| RHEL 8.1 | 4.18.0-240 |
| RHEL 7.9、CentOS 7.9 | 3.10.0-1160 |
| RHEL 7.8、CentOS 7.8 | 3.10.0-1160 |
| SUSE 12.5 | 4.12.14 |
| ウブントゥ 20.04 | 5.4.0-81 |
| ウブントゥ 18.04 | 4.15.0-154 |
| ウブントゥ 16.04 | 4.4.0-210 |
| デビアン 10 | 4.19.0-17 |
重要:
マシンのカーネルがLinux VDA用に構築されたドライバーと互換性がない場合、USBサービスが起動しないことがあります。この場合、独自のVHCIカーネルモジュールを構築した場合にのみ、USBリダイレクト機能を使用できます。
カーネルがCitrixによって構築されたモジュールと整合しているかを確認する
コマンドラインで、次のコマンドを実行してカーネルが整合しているかを確認します。
insmod /opt/Citrix/VDA/lib64/usb-vhci-hcd.ko
コマンドが正常に実行された場合、カーネルモジュールは正常にロードされており、バージョンはCitrixによってインストールされたものと整合しています。
コマンドの実行中にエラーが発生した場合、カーネルはCitrixモジュールと整合しておらず、再構築する必要があります。
VHCIカーネルモジュールを再構築する
カーネルモジュールがCitrixのバージョンと整合していない場合は、次の手順を実行します。
-
CitrixダウンロードサイトからLVDAソースコードをダウンロードします。「Linux Virtual Delivery Agent (sources)」セクションのファイルを選択します。
-
citrix-linux-vda-sources.zipファイルを展開します。linux-vda-sources/vhci-hcd-1.15.zipに移動し、
unzip vhci-hcd-1.15.zipコマンドを使用してVHCIソースファイルを展開します。 -
Linux VDAパッケージがインストールされていることを確認してから、次のいずれかのコマンドを実行します。
-
sudo bash ctxusbcfg.sh dkmsこのコマンドを使用すると、Dynamic Kernel Module Support (DKMS) プログラムを使用してVHCIカーネルモジュールを管理できます。DKMSはSUSEでは利用できません。注:sudo bash ctxusbcfg.sh dkmsコマンドは、VDAにkernel-develおよびDKMSプログラムをインストールします。RHELおよびCentOSにプログラムをインストールする場合、このコマンドはVDAにExtra Packages for Enterprise Linux (EPEL) リポジトリをインストールして有効にします。DKMSは、メジャーなカーネルアップグレード（例: バージョン4.x.yからバージョン5.x.yへ）を実行する際に、VHCIカーネルモジュール（usb-vhci-hcd.koおよびusb-vhci-iocif.ko）のビルドに失敗する可能性があります。DKMSが失敗した場合は、sudo bash ctxusbcfg.sh dkmsを再度実行してください。 -
sudo bash ctxusbcfg.sh buildこのコマンドは、DKMSオプションなしでVHCIカーネルモジュールをビルドしてインストールします。
-
USBリダイレクトの問題をトラブルシューティングする
このセクションの情報を使用して、Linux VDA の使用中に発生する可能性のあるさまざまな問題をトラブルシューティングしてください。
リダイレクトされた USB ディスクをアンマウントできない
Linux VDA は、Citrix Workspace アプリからリダイレクトされたすべての USB ディスクを管理者権限で管理し、所有者のみがリダイレクトされたデバイスにアクセスできるようにします。そのため、デバイスをアンマウントするには管理者権限が必要です。
デバイスをアンマウントできない(/en-us/linux-virtual-delivery-agent/2201/media/unable-to-mount-disk.png)
USB ディスクのリダイレクトを停止するとファイルが失われる
Citrix Workspace アプリのツールバーを使用して USB ディスクのリダイレクトをすぐに停止すると、ディスク上で変更または作成したファイルが失われる可能性があります。この問題は、ファイルシステムにデータを書き込む際に、システムがファイルシステム内のメモリキャッシュをマウントするため発生します。データはディスク自体には書き込まれません。Citrix Workspace アプリのツールバーを使用してリダイレクトを停止すると、データがディスクにフラッシュされる時間がなくなり、データが失われます。この問題を解決するには、USB リダイレクトを停止する前に、ターミナルで sync コマンドを使用してデータをディスクにフラッシュしてください。
USB ディスクのリダイレクトを停止するとファイルが失われる(/en-us/linux-virtual-delivery-agent/2201/media/file-lost-issue.png)
Citrix Workspace アプリのツールバーにデバイスがない
Citrix Workspace アプリのツールバーにデバイスが表示されないことがあり、これは USB リダイレクトが行われていないことを示します。この問題が発生した場合は、以下を確認してください。
-
ポリシーが USB リダイレクトを許可するように構成されている
-
カーネルモジュールがご使用のカーネルと互換性がある
Workspace アプリのツールバーにあるデバイスタブ(/en-us/linux-virtual-delivery-agent/2201/media/client-usb-redirection-troubleshoot.png)
注:
デバイスタブは、Linux 版 Citrix Workspace アプリでは利用できません。
Citrix Workspace アプリのツールバーに USB デバイスが表示されるが、「ポリシーによって制限されています」と表示され、リダイレクトに失敗する
この問題が発生した場合は、次の操作を行います。
-
Linux VDAポリシーを構成してリダイレクトを有効にします。
-
Citrix Workspaceアプリのレジストリに追加のポリシー制限が構成されていないか確認します。レジストリパスの DeviceRules を確認して、この設定によってデバイスへのアクセスが拒否されていないことを確認します。HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Wow6432Node\\Citrix\\ICA Client\\GenericUSB
USBデバイスは正常にリダイレクトされましたが、セッションで使用できません
通常、リダイレクトできるのはサポートされているUSBデバイスのみです。他のデバイスもアクティブなLinux VDAセッションにリダイレクトされる場合があります。リダイレクトされたデバイスごとに、ユーザーが所有するノードがシステム /dev パスに作成されます。ただし、ユーザーがデバイスを正常に使用できるかどうかは、ドライバーと構成によって決まります。所有されている（接続されている）がアクセスできないデバイスが見つかった場合は、そのデバイスを無制限のポリシーに追加してください。
注:
USBドライブの場合、Linux VDAはディスクを構成してマウントします。ユーザー（およびインストールした所有者のみ）は、追加の構成なしでディスクにアクセスできます。これは、サポートされているデバイスリストにないデバイスには当てはまらない場合があります。