非仮想化GPU

最終公開日 : Nov 13, 2026
Linux VDAドキュメントでは、非仮想化GPUは以下を指します。
  • リモートPCアクセスシナリオで使用されるGPU
  • ハイパーバイザーからパススルーされたGPU
この記事では、非仮想化GPUのサポートに関する情報を提供します。

NVIDIA Capture SDK for LinuxをサポートするNVIDIA GPUでHDX™ 3D Proを有効にする

NVIDIA Capture SDK for LinuxをサポートするNVIDIA GPUの場合、Linux VDAのインストール時にCTX_XDL_HDX_3D_PROをYに設定するだけで、HDX 3D Proを有効にできます。追加の構成は不要です。HDX 3D Proを有効にすると、ハードウェアアクセラレーションはデフォルトで有効になります。

NVIDIA Capture SDK for LinuxをサポートしないNVIDIA GPU、およびAMDやIntelなどの他のメーカーのGPUとの互換性

注:
このシナリオでは、ソフトウェアエンコードのみがサポートされます。

ステップ1:Linux VDAのインストール時にCTX_XDL_HDX_3D_PROをYに設定する

環境変数については、「ステップ8:インストールを完了するためのランタイム環境のセットアップ」を参照してください。

ステップ2:Xdamageをインストールする

たとえば、sudo apt-get install -y libxdamage1を実行して、Ubuntu 20.04にXDamageをインストールできます。通常、XDamageはXServerの拡張機能として存在します。

ステップ3:次のコマンドを実行してXDamageを有効にする

/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_DWORD" -v "XDamageEnabled" -d "0x00000001" --force

ステップ4:Xorg構成ファイルを変更する

/etc/X11 の下に、次の4つのテンプレート構成ファイルがあります。接続されているモニターの数に基づいて、名前に対応する番号が含まれるテンプレート構成ファイルのいずれかを変更します。たとえば、モニターが1台のみ接続されている場合は、名前に番号1が含まれるテンプレート構成ファイル、つまり ctx-driver_name-1.conf を変更します。モニターが2台接続されている場合は、名前に番号2が含まれるテンプレート構成ファイル、つまり ctx-driver_name-2.conf を変更します。
  • 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 を例として、テンプレート構成ファイルを変更するには、次の手順を実行します。
  1. driver\_name を実際のドライバー名に置き換えます。
    たとえば、ドライバー名が intel の場合、構成ファイル名を ctx-intel-1.conf に変更できます。
  2. ビデオドライバー情報を追加します。
    各テンプレート構成ファイルには、「Device」という名前のセクションが含まれており、コメントアウトされています。このセクションはビデオドライバー情報を記述します。ビデオドライバー情報を追加する前に、このセクションを有効にします。このセクションを有効にするには:
    1. 構成情報については、GPUメーカーが提供するガイドを参照してください。ネイティブ構成ファイルを生成できます。ネイティブ構成ファイルを使用して、GPUがローカル環境で動作することを確認してください。
    2. ネイティブ構成ファイルの「Device」セクションを ctx-driver\_name-1.conf にコピーします。
  3. 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

リモートPCアクセスVDAのモニターブランキング

Linux VDAは、非仮想化GPUを使用するリモートPCアクセスVDAの物理モニターブランキングをサポートしています。
この機能をサポートする完全にテスト済みのLinuxディストリビューションには、Ubuntu 20.04とDebian 11が含まれます。
この機能はデフォルトで無効になっています。有効にするには、次の2つの手順を完了します。
  1. お使いのLinuxディストリビューションに基づいて、evdi-dkmsパッケージをインストールします。
    sudo apt install evdi-dkms
  2. EVDIへのグラフィックディスプレイオフロードを有効にします。
    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force
  3. Intel GPUを使用している場合は、ディスプレイマネージャーを無効にします。そうしないと、ディスプレイマネージャーがIntel GPUを占有し、Citrix®リモートセッションで利用できなくなります。
    sudo systemctl disable --now gdm

トラブルシューティング

グラフィック出力がない、または文字化けしている

3Dアプリケーションをローカルで実行でき、すべての構成が正しい場合、グラフィック出力がない、または文字化けしているのはバグの結果です。デバッグ用のトレース情報を収集するには、/opt/Citrix/VDA/bin/setlogを使用し、GFX\_X11をverboseに設定します。