グラフィックの構成

最終公開日 : Nov 13, 2026
この記事では、Linux VDAのグラフィック構成と微調整に関するガイダンスを提供します。
詳細については、システム要件およびインストール概要のセクションを参照してください。

構成パラメーター

HKEY\_LOCAL\_MACHINE\System\CurrentControlSet\Control\Citrix\Thinwireには、ctxregユーティリティで調整できるグラフィック関連の構成パラメーターがいくつかあります。

Thinwire Plusを有効にする方法

Thinwire Plusは、標準VDAと3D Proの両方でデフォルトで有効になっています。

H.264を有効にする方法

オペレーティングシステムの要件に加えて、H.264にはCitrix Workspaceアプリ(旧Citrix Receiver)のバージョンの最小要件があります。クライアントが要件を満たさない場合、Thinwire Plusにフォールバックします。
オペレーティングシステム H.264の最小要件
ウィンドウズ 3.4以降
マック オーエス テン 11.8以降
リナックス 13.0以降
アンドロイド 3.5
iOS 5.9
クローム OS 1.4
Citrix Workspace app の最新の機能マトリックスは <https://docs.citrix.com/ja-jp/citrix-workspace-app/citrix-workspace-app-feature-matrix.html> で入手できます。
VDA で H.264 エンコーディングをアドバタイズするには、次のコマンドを実行します。
sudo ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AdvertiseH264" -d "0x00000001" --force

HDX™ 3D Pro でハードウェアエンコーディングを有効にする方法

HDX 3D Pro の場合、AdvertiseH264 設定はソフトウェア H.264 エンコーディングのみを有効にします。 ハードウェアエンコーディングを有効にするには、次のコマンドを実行します。
sudo ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000001" --force
注:
ctxreg command can't be found エラーが発生した場合は、完全なパスを指定して ctxreg コマンドを使用してください。たとえば、sudo ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AdvertiseH264" -d "0x00000001" –force の代わりに sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AdvertiseH264" -d "0x00000001" –force を使用します。

低帯域幅向けに Thinwire Plus を調整する方法

  • MaxColorDepth
    Default 0x20, type DWORD
    このオプションは、Thinwire プロトコルを介してクライアントに転送されるグラフィックの色深度を指定します。
    帯域幅を節約するには、0x10 (シンプルなグラフィックに推奨される色深度を表します) または 0x8 (実験的な低帯域幅モード) に設定します。
  • 品質
    視覚的な品質
    Default: 0x1(medium), type: DWORD, valid values: 0x0(low), 0x1(medium), 0x2(high), 0x3(build to lossless), 0x4 always lossless.
    帯域幅を節約するには、Quality を 0x0 (低) に設定します。
  • その他のパラメーター
    • TargetFPS
      ターゲットフレームレート
      Default: 0x1e (30), Type: DWORD
    • MinFPS
      目標最小フレームレート
      Default: 0xa (10), Type: DWORD
    • MaxScreenNum
      クライアントが持つことができるモニターの最大数
      Default: 0x2, Type: DWORD
      標準VDAの場合、最大10まで設定できます。3D Proの場合、許可される最大値は4です。

トラブルシューティング

使用中のエンコードを確認する

H.264エンコードが使用されているかどうかを確認するには、次のコマンドを実行します(1はH.264を意味し、0はTW+を意味します)。
sudo ctxreg dump | grep H264
結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\1\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000001" --force
create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AdvertiseH264" -d "0x00000001" --force

3D Proでハードウェアエンコードが使用されているか確認する

次のコマンドを実行します(0は使用されていないことを意味し、1は使用中であることを意味します)。
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep HardwareEncoding
結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\1\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000001" --force
別の方法として、nvidia-smiコマンドを使用します。ハードウェアエンコードが使用されている場合、出力は次のようになります。
Tue Apr 12 10:42:03 2016
+------------------------------------------------------+
| NVIDIA-SMI 361.28     Driver Version: 361.28         |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  GRID K1             Off  | 0000:00:05.0     Off |                  N/A |
| N/A   42C    P0    14W /  31W |    207MiB /  4095MiB |      8%      Default |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID  Type  Process name                               Usage      |
|=============================================================================|
|    0      2164  C+G   /usr/local/bin/ctxgfx                          106MiB |
|    0      2187    G   Xorg                                            85MiB |
+-----------------------------------------------------------------------------+

NVIDIA GRIDグラフィックドライバーが正しくインストールされていることを確認する

NVIDIA GRIDグラフィックドライバーが正しくインストールされていることを確認するには、nvidia-smiを実行します。結果は次のようになります。
+------------------------------------------------------+
| NVIDIA-SMI 352.70     Driver Version: 352.70         |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  Tesla M60           Off  | 0000:00:05.0     Off |                  Off |
| N/A   20C    P0    37W / 150W |     19MiB /  8191MiB |      0%      Default |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID  Type  Process name                               Usage      |
|=============================================================================|
|  No running processes found                                                 |
+-----------------------------------------------------------------------------+
カードの正しい構成を設定します。
etc/X11/ctx-nvidia.sh

HDX 3D Proマルチモニターの再描画に関する問題

プライマリモニター以外の画面で再描画の問題が発生している場合は、NVIDIA GRIDライセンスが利用可能であることを確認してください。

Xorgエラーログを確認する

Xorg のログファイルは、/var/log/ フォルダーに Xorg.{DISPLAY}.log と同様の名前で保存されます。

既知の問題と制限事項

vGPU の場合、XenServer® ローカルコンソールに ICA デスクトップセッション画面が表示される

回避策: 次のコマンドを実行して、VM のローカル VGA コンソールを無効にします。
xe vm-param-set uuid=<vm-uuid> platform:vgpu_extra_args="disable_vnc=1"

NVENC API は 8Q 以外の vGPU プロファイルではサポートされていません

NVIDIA Tesla M60 カードの 8Q 以外の vGPU プロファイルは CUDA をサポートしていないため、NVENC API および Citrix® 3D Pro ハードウェアエンコーディングは利用できません。

NVIDIA K2 グラフィックカードはパススルーモードで YUV444 ハードウェアエンコーディングをサポートしていません

これは NVIDIA K2 グラフィックカードの制限です。

Gnome 3 デスクトップのポップアップがログオン時に遅い

これは Gnome 3 デスクトップセッションの起動の制限です。

Citrix Receiver ウィンドウのサイズ変更時に一部の OpenGL/WebGL アプリケーションが適切にレンダリングされない

Citrix Receiver ウィンドウのサイズを変更すると、画面解像度が変更されます。NVIDIA 独自のドライバーは一部の内部状態を変更し、アプリケーションがそれに応じて応答する必要がある場合があります。たとえば、WebGL ライブラリ要素 lightgl.js は「Rendering to this texture is not supported (incomplete frame buffer)」というエラーを発生させる可能性があります。