非仮想化GPU
Linux VDAのドキュメントでは、非仮想化GPUとは以下を指します。
-
リモートPCアクセスシナリオで使用されるGPU
-
ハイパーバイザーからパススルーされたGPU
この記事では、非仮想化GPUでHDX™ 3D Proを有効にする方法について説明します。
前提条件
-
HDX 3D Proを有効にします。これを行うには、Linux VDAのインストール時に
CTX_XDL_HDX_3D_PROをYに設定します。環境変数については、「手順8：インストールを完了するためのランタイム環境のセットアップ」を参照してください。 -
NVIDIA Linux Capture SDKがサポートするGPUの場合、HDX 3D Proを有効にすると、ハードウェアアクセラレーションがデフォルトで有効になります。追加の構成は不要です。
-
NVIDIA Linux Capture SDKがサポートしないGPUの場合は、
XDamageをインストールします。たとえば、Ubuntu 20.04にXDamageをインストールするには、sudo apt-get install -y libxdamage1を実行します。通常、XDamageはXServerの拡張機能として存在します。
構成
Xorg構成ファイルを変更する
NVIDIA非仮想化GPUの場合
構成ファイルは自動的にインストールおよび設定されます。
その他のGPUの場合
/etc/X11/にインストールされている4つのテンプレート構成ファイルを変更する必要があります。
-
ctx-driver\_name-1.conf
-
ctx-driver\_name-2.conf
-
ctx-driver\_name-3.conf
-
ctx-driver\_name-4.conf
ctx-driver\_name-1.conf を例として、テンプレート構成ファイルを変更するには、以下を実行します。
-
driver\_name を実際のドライバー名に置き換えます。例えば、ドライバー名が
intelの場合、構成ファイル名をctx-intel-1.confに変更できます。 -
ビデオドライバー情報を追加します。各テンプレート構成ファイルには、「Device」という名前のセクションが含まれており、コメントアウトされています。このセクションにはビデオドライバー情報が記述されています。ビデオドライバー情報を追加する前に、このセクションを有効にします。このセクションを有効にするには：
-
構成情報については、GPU メーカーが提供するガイドを参照してください。ネイティブ構成ファイルを生成できます。ネイティブ構成ファイルを使用して、GPU がローカル環境で動作することを確認してください。
-
ネイティブ構成ファイルの「Device」セクションを ctx-driver\_name-1.conf にコピーします。
-
-
次のコマンドを実行してレジストリキーを設定し、Linux VDA がステップ1で設定した構成ファイル名を認識できるようにします。
/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_SZ" -v "DriverName" -d "intel" --force
XDamage を有効にする
NVIDIA Linux Capture SDK のリリースノートのサポートされているハードウェアセクションに記載されていない GPU を使用している場合は、
XDamage を使用して有効にします。
/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_DWORD" -v "XDamageEnabled" -d "0x00000001" --force
Remote PC Access VDA のモニターブランキング
Linux VDA は、非仮想化 GPU を使用する Remote PC Access VDA の物理モニターブランキングをサポートしています。
この機能をサポートする完全にテスト済みの Linux ディストリビューションには、Ubuntu 20.04 および Debian 11.3 が含まれます。
この機能はデフォルトで無効になっています。有効にするには、次の2つの手順を完了します。
-
お使いのLinuxディストリビューションに基づいて、
evdi-dkmsパッケージをインストールします。sudo apt install evdi-dkms -
EVDIへのグラフィックディスプレイオフロードを有効にします。
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force -
Intel GPUを使用している場合は、ディスプレイマネージャーを無効にします。そうしないと、Intel GPUがディスプレイマネージャーによって占有され、Citrix®リモートセッションで利用できなくなります。
sudo systemctl disable --now gdm
トラブルシューティング
グラフィック出力がない、または文字化けしている
3Dアプリケーションをローカルで実行でき、すべての構成が正しい場合、グラフィック出力の欠落または文字化けはバグが原因です。デバッグ用のトレース情報を収集するには、/opt/Citrix/VDA/bin/setlogを使用し、GFX\_X11をverboseに設定します。
ハードウェアエンコードが機能しない
Xdamageを使用する場合、ソフトウェアエンコードのみがサポートされます。