Linux Virtual Delivery Agent

グラフィックスの構成と微調整

この記事では、Linux VDAのグラフィックスの構成と微調整に関するガイダンスを提供します。

詳細については、「システム要件」および「インストール概要」セクションを参照してください。

構成

  • 圧縮用ビデオコーデック

Thinwireは、Linux VDAで使用されるディスプレイリモート処理テクノロジーです。このテクノロジーにより、あるマシンで生成されたグラフィックスを、通常はネットワークを介して別のマシンに送信し、表示できます。

  • 圧縮にビデオコーデックを使用 グラフィックスポリシーは、デフォルトのグラフィックスモードを設定し、さまざまなユースケースに対して以下のオプションを提供します。

  • 優先する場合にのみ使用。この設定はデフォルトです。追加の構成は不要です。これにより、すべてのCitrix®接続でThinwireが選択され、一般的なデスクトップワークロードのスケーラビリティ、帯域幅、および優れた画質のために最適化されます。
  • 画面全体に適用。ThinwireをフルスクリーンH.264またはH.265で提供し、特に3Dグラフィックスを多用する場合に、ユーザーエクスペリエンスと帯域幅の向上を最適化します。
  • アクティブに変更される領域に適用。Thinwireのアダプティブディスプレイテクノロジーは、動的な画像(ビデオ、モーション内の3D)を識別します。画像が動いている画面の部分でのみH.264を使用します。H.264ビデオコーデックを選択的に使用することで、HDX Thinwireは、H.264ビデオコーデックを使用して頻繁に更新される画面の部分を検出し、エンコードできます。静止画圧縮(JPEG、RLE)とビットマップキャッシュは、テキストや写真画像を含む画面の残りの部分で引き続き使用されます。ユーザーは、ビデオコンテンツの帯域幅消費量の削減と品質の向上、およびその他の場所でのロスレステキストまたは高品質画像の組み合わせというメリットを得られます。この機能を有効にするには、[圧縮にビデオコーデックを使用] ポリシーを [優先する場合にのみ使用](デフォルト)または [アクティブに変更される領域に適用] に設定します。詳しくは、「グラフィックスポリシー設定」を参照してください。この機能のH.264ハードウェアエンコーディングを有効にするには、「H.264ハードウェアエンコーディング」を参照してください。

    画面全体が選択されている状態

以下の視覚表示ポリシー設定を含む、その他のいくつかのポリシー設定を使用して、ディスプレイリモート処理のパフォーマンスを微調整できます。

  • 簡易グラフィックスの優先色深度
  • ターゲットフレームレート
  • 視覚的品質

  • H.264ハードウェアエンコーディング

  • [ビデオコーデックのハードウェアエンコーディングを使用] ポリシーでは、利用可能な場合、グラフィックスハードウェアを使用して、ビデオコーデックで画面要素を圧縮できます。このようなハードウェアが利用できない場合、VDAはソフトウェアビデオコーデックを使用したCPUベースのエンコーディングにフォールバックします。

バージョン2204以降、Linux VDAは、アクティブに変更される領域に対してH.264ハードウェアコーデックを選択的に使用することをサポートしています。この機能は、CPUのビデオ圧縮消費をハードウェアにオフロードし、画質と1秒あたりのフレーム数(FPS)を向上させます。この機能を有効にするには、次の手順を実行します。

  1. [ビデオコーデックのハードウェアエンコーディングを使用] ポリシーを有効にします。
    1. [圧縮にビデオコーデックを使用] ポリシーを有効にし、[アクティブに変更される領域に適用] を選択します。

視覚的にロスレスな圧縮の許可

[視覚的にロスレスな圧縮を許可] ポリシーでは、グラフィックスに対して真のロスレス圧縮の代わりに視覚的にロスレスな圧縮を使用できます。視覚的にロスレスな圧縮は、真のロスレス圧縮よりもパフォーマンスが向上しますが、目視では認識できないわずかな損失があります。この設定は、[視覚的品質] 設定の値の使用方法を変更します。

[視覚的にロスレスな圧縮を許可] ポリシーはデフォルトで無効になっています。視覚的にロスレスな圧縮を有効にするには、[視覚的にロスレスな圧縮を許可][有効] に設定し、[視覚的品質] ポリシーを [ロスレスにビルド] に設定します。

[圧縮にビデオコーデックを使用] ポリシーが [ビデオコーデックを使用しない] に設定されている場合、視覚的にロスレスな圧縮は静止画エンコーディングに適用されます。[圧縮にビデオコーデックを使用] ポリシーが [ビデオコーデックを使用しない] 以外のグラフィックスモードに設定されている場合、視覚的にロスレスな圧縮はH.264エンコーディングに適用されます。

以下のクライアントは、選択的H.264をサポートしています。

  • Citrix Receiver for Windows 4.9~4.12
    • Citrix Receiver for Linux 13.5~13.10
    • Citrix Workspace™アプリ1808 for Windows以降
    • Citrix Workspaceアプリ1808 for Linux以降

[視覚的品質] および [圧縮にビデオコーデックを使用] ポリシー設定の詳細については、「視覚表示ポリシー設定」および「グラフィックスポリシー設定」を参照してください。

H.265ビデオコーデックのサポート

7.18リリース以降、Linux VDAは、リモートグラフィックスおよびビデオのハードウェアアクセラレーションのためにH.265ビデオコーデックをサポートしています。

この機能は、以下の環境で使用できます。

  • Citrix Receiver for Windows 4.10~4.12
  • Citrix Workspaceアプリ1808 for Windows以降

この機能を利用するには、Linux VDAとクライアントの両方で有効にします。クライアントのGPUがDXVAインターフェースを使用したH.265デコーディングをサポートしていない場合、グラフィックスポリシー設定のH.265デコーディングは無視され、セッションはH.264ビデオコーデックの使用にフォールバックします。詳しくは、「H.265ビデオエンコーディング」を参照してください。

-  VDAでH.265ハードウェアエンコーディングを有効にするには:
  1. [ビデオコーデックのハードウェアエンコーディングを使用] ポリシーを有効にします。
  2. [3Dグラフィックスワークロード用に最適化] ポリシーを有効にします。
  3. [圧縮にビデオコーデックを使用] ポリシーがデフォルトであるか、[画面全体に適用] に設定されていることを確認します。
  4. [視覚的品質] ポリシーが [ロスレスにビルド] または [常にロスレス] に設定されていないことを確認します。

クライアントでH.265ハードウェアエンコーディングを有効にするには、「H.265ビデオエンコーディング」を参照してください。

YUV444ソフトウェアエンコーディングのサポート

Linux VDAはYUV444ソフトウェアエンコーディングをサポートしています。YUVエンコーディングスキームは、各ピクセルに輝度値と色値の両方を割り当てます。YUVでは、「Y」は輝度または「luma」値を表し、「UV」は色または「chroma」値を表します。この機能は、Citrix Receiver for Windows 4.10~4.12、およびCitrix Workspaceアプリ1808 for Windows以降で使用できます。

各Y、U、またはVの一意の値は、8ビット、つまり1バイトのデータで構成されます。YUV444データ形式は、ピクセルあたり24ビットを送信します。YUV422データ形式は、2つのピクセル間でU値とV値を共有するため、平均送信レートはピクセルあたり16ビットになります。次の表は、YUV444とYUV420の直感的な比較を示しています。

YUV444 YUV420
YUV444 YUV420

VDAでYUV444ソフトウェアエンコーディングを有効にするには:

  1. [圧縮にビデオコーデックを使用] ポリシーが [画面全体に適用] に設定されていることを確認します。

  2. ビジュアル品質ポリシーが常にロスレスまたはロスレスにビルドに設定されていることを確認します。

グラフィック品質スライダー

仮想Linuxセッションで実行されるグラフィックステータスインジケーターツールに、グラフィック品質スライダーを組み込みました。このスライダーは、画質とインタラクティブ性の適切なバランスを見つけるのに役立ちます。

スライダーを使用するには、次の手順を実行します。

  1. Citrix Studio で グラフィックステータスインジケーター ポリシーを有効にします。

    グラフィックステータスインジケーターポリシー

  2. ターミナルを開き、ctxslider コマンドを実行します。スライダー UI が表示されます。

    注:

    視覚品質ポリシーを常にロスレスまたはロスレスにビルドに設定している場合、スライダー UI は表示されません。

    グラフィック品質スライダー

    次の選択肢が利用可能です。

    • 画質を変更するには、スライダーを動かします。スライダーは 0~9 の範囲をサポートしています。
    • システム定義の設定を使用するには、システムに決定させるを選択します。
    • ロスレスモードに切り替えるには、ピクセルパーフェクトを選択します。

帯域幅の見積もりに基づく平均ビットレートの調整

Citrix は、帯域幅の見積もりに基づいて平均ビットレートを調整することで、HDX™ 3D Pro ハードウェアエンコーディングを強化します。

HDX 3D Pro ハードウェアエンコーディングが使用されている場合、VDA はネットワークの帯域幅を断続的に推定し、それに応じてエンコードされたフレームのビットレートを調整できます。この新機能は、鮮明さと流暢さのバランスを取るメカニズムを提供します。

この機能はデフォルトで有効になっています。無効にするには、次のコマンドを実行します。

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "DisableReconfigureEncoder" -d "0x00000001" --force
<!--NeedCopy-->

この機能を使用することに加えて、鮮明さと流暢さの間で調整するために次のコマンドを実行することもできます。AverageBitRatePercent および MaxBitRatePercent パラメーターは、帯域幅使用率のパーセンテージを設定します。設定する値が高いほど、グラフィックはより鮮明になり、流暢さは低下します。推奨される設定範囲は 50~100 です。

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AverageBitRatePercent" -d "90" --force

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "MaxBitRatePercent" -d "100" --force
<!--NeedCopy-->

平均ビットレート調整では、画面が静止しているときに新しいフレームが送信されないため、最新のフレームは低品質の状態で維持されます。シャープ化サポートは、最新のフレームを最高品質で再構成してすぐに送信することで、この問題に対処できます。

Linux VDA Thinwire でサポートされているポリシーの完全なリストについては、「ポリシーサポートリスト」を参照してください。

Linux VDA でのマルチモニターサポートの構成については、「CTX220128」を参照してください。

並列処理

Thinwire は、特定のタスクを並列化することで、わずかに高い全体的な CPU 消費量のオーバーヘッドを伴いながら、1 秒あたりのフレーム数 (FPS) を向上させることができます。この機能はデフォルトで無効になっています。この機能を有効にするには、VDA で次のコマンドを実行します。

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "ParallelProcessing" -d "0x00000001" --force
<!--NeedCopy-->

トラブルシューティング

使用中のグラフィックモードの確認

使用中のグラフィックモードを確認するには、次のコマンドを実行します (0 は TW+ を意味します。1 は全画面ビデオコーデックを意味します)。

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep GraphicsMode
<!--NeedCopy-->

結果は次のようになります。

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "GraphicsMode" -d "0x00000000" --force

H.264 の使用状況の確認

H.264 が使用されているかどうかを確認するには、次のコマンドを実行します (0 は使用されていないことを意味します。1 は使用中であることを意味します)。

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep H264
<!--NeedCopy-->

結果は次のようになります。

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000000" --force

H.265 の使用状況の確認

全画面 H.265 が使用されているかどうかを確認するには、次のコマンドを実行します (0 は使用されていないことを意味します。1 は使用中であることを意味します)。

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep H265
<!--NeedCopy-->

結果は次のようになります。

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H265" -d "0x00000000" --force

使用中の YUV エンコーディングスキームの確認

使用中の YUV エンコーディングスキームを確認するには、次のコマンドを実行します (0 は YUV420 を意味します。1 は YUV422 を意味します。2 は YUV444 を意味します)。

注: YUVFormat の値は、ビデオコーデックが使用されている場合にのみ意味があります。

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep YUVFormat
<!--NeedCopy-->

結果は次のようになります。

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "YUVFormat" -d "0x00000000" --force

YUV444ソフトウェアエンコーディングの使用状況を確認

YUV444ソフトウェアエンコーディングが使用されているかどうかを確認するには、次のコマンドを実行します。

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep Graphics
<!--NeedCopy-->

YUV444が使用されている場合、結果は次のようになります。

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "GraphicsMode" -d "0x00000001" --force create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000001" --force create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000000" --force create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "YUVFormat" -d "0x00000002" --force

3D Proでのハードウェアエンコーディングの使用状況を確認

次のコマンドを実行します(0は未使用、1は使用中を意味します)。

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep HardwareEncoding
<!--NeedCopy-->

結果は次のようになります。

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 |
+-----------------------------------------------------------------------------+
<!--NeedCopy-->

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                                                 |
+-----------------------------------------------------------------------------+
<!--NeedCopy-->

カードの正しい設定を行います。

etc/X11/ctx-nvidia.sh

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

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

Xorgエラーログの確認

Xorgのログファイルは、/var/log/フォルダー内にXorg.{DISPLAY}.logのような名前で保存されています。

既知の問題と制限事項

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

回避策:次のコマンドを実行して、VMのローカルVGAコンソールを無効にします。

Citrix Hypervisor 8.1以降の場合:

[root@xenserver® ~]# xe vgpu-param-set uuid=vgpu-uuid extra_args=disable_vnc=1
<!--NeedCopy-->

Citrix Hypervisor 8.1より前の場合:

xe vm-param-set uuid=<vm-uuid> platform:vgpu_extra_args="disable_vnc=1"
<!--NeedCopy-->

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

ポリシー設定でBuild to Losslessが有効になっている場合、NVIDIA K2グラフィックカードを使用してアプリ/デスクトップセッションを起動すると、黒または灰色の画面が表示されます。この問題は、NVIDIA K2グラフィックカードがパススルーモードでYUV444ハードウェアエンコーディングをサポートしていないために発生します。詳細については、Video Encode and Decode GPU Support Matrixを参照してください。

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

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

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

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

グラフィックスの構成と微調整