非仮想化GPU

最終公開日 : Nov 13, 2026
Linux VDAのドキュメントでは、非仮想化GPUは以下を指します。
  • リモートPCアクセスシナリオで使用されるGPU
  • ハイパーバイザーからパススルーされたGPU
この記事では、非仮想化GPUでHDX™ 3D Proを有効にする方法について説明します。
Related information
グラフィックス

前提条件

  • 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 を例として、テンプレート構成ファイルを変更するには、次の手順を実行します。
  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

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

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

Linux VDA は、非仮想化 GPU を使用するリモート PC アクセス VDA の物理モニターブランキングをサポートしています。
この機能をサポートする完全にテスト済みの Linux ディストリビューションには、Ubuntu 20.04 および Debian 11.3 が含まれます。
この機能はデフォルトで無効になっています。有効にするには、次の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に設定してください。

ハードウェアエンコードが機能しない

Xdamage を使用する場合、ソフトウェアエンコードのみがサポートされます。