Linux仮想配信エージェント 2411

非仮想化GPU

  • 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_PROYに設定するだけで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に設定する

たとえば、Ubuntu 20.04にXDamageをインストールするには、sudo apt-get install -y libxdamage1を実行します。通常、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
<!--NeedCopy-->

ステップ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
    <!--NeedCopy-->
    

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

Linux VDAは、非仮想化GPUを使用するリモートPCアクセスVDAの物理モニターブランキングをサポートしています。

この機能をサポートする完全にテスト済みのLinuxディストリビューションには、Ubuntu 20.04およびDebian 11が含まれます。

この機能はデフォルトで無効になっています。有効にするには、次の2つの手順を完了します。

  1. Linuxディストリビューションに基づいてevdi-dkmsパッケージをインストールします。

    sudo apt install evdi-dkms
    <!--NeedCopy-->
    
  2. EVDIへのグラフィックディスプレイオフロードを有効にします。

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "Evdi" -d "0x00000001" --force
    <!--NeedCopy-->
    
  3. Intel GPUを使用している場合は、ディスプレイマネージャーを無効にします。そうしないと、ディスプレイマネージャーがIntel GPUを占有し、Citrix®リモートセッションで利用できなくなります。

    sudo systemctl disable --now gdm
    <!--NeedCopy-->
    

トラブルシューティング

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

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