リナックス バーチャル デリバリー エージェント

VDAとデリバリーコントローラーとの間のWebSocket通信

この記事では、Windows Communication Foundation (WCF) の代替手段として、VDAとデリバリーコントローラーとの間でWebSocket通信を確立する手順について説明します。

ステップ1:デリバリーコントローラーでウェブソケットを有効にする

  1. サイトを構成します。詳しくは、「サイトの作成」を参照してください。

  2. サイト上の各Delivery ControllerにTLS証明書をインストールします。詳しくは、「ControllerへのTLSサーバー証明書のインストール」を参照してください。

  3. 次のコマンドを使用して、各Delivery Controller™でWebSocket通信を有効にします。

    New-ItemProperty "HKLM:\SOFTWARE\Citrix\DesktopServer\WorkerProxy" -Name "WebSocket_Enabled" -PropertyType "DWord" -Value 1 -Force
    <!--NeedCopy-->
    

    注:

    WebSocketを有効にした後、必ずDelivery Controllerを再起動してください。

ステップ2:VDAでWebSocketを有効にする

  1. Delivery Controllerを信頼するために、ルートおよび中間認証局(CA)をVDAにインストールします。

  2. VDAの作成方法に基づいて、VDAのWebSocket通信を有効にします。

    • ドメインに参加していないVDA

      WebSocket通信はデフォルトで有効になっています。追加の構成は不要です。

    • 簡易インストールを使用して作成されたドメイン参加済みVDA

      最初に簡易インストールスクリプト(ctxinstall.sh)を実行する前に、/opt/Citrix/VDA/sbin/ctxinstall.confで次の環境変数を設定してWebSocketを有効にします。

      • **CTX_XDL_DJ_ENROLLMENT_TOKEN_FILE= ’** – WebSocket の有効化を制御し、VDA 登録用のトークンファイルを指定します。デフォルト値は **‘’** で、WebSocket が無効になっていることを意味します。ドメイン参加済み VDA で WebSocket を有効にするには、トークンファイルへのパスを入力します。
      • **CTX_XDL_ENROLLMENT_TOOL_USING_LDAPS=’y n’** – 登録ツールが LDAP または LDAPS のどちらかを照会するように構成します。デフォルトでは、LDAP (‘n’) を照会します。LDAPS を使用するには、値を ‘y’ に設定します。
    • マシンクリエーションサービス™ (MCS) を使用して作成されたドメイン参加済みVDA:

      テンプレートマシンで /etc/xdl/mcs/mcs_local_setting.reg を開き、WebSocket を有効にするために次のようなコマンドラインを追加します。

       create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t "REG_DWORD" -v "CbpTransportVersion2" -d "0x00000001" --force
       <!--NeedCopy-->
      

      このコマンドは、CbpTransportVersion2 レジストリキーを作成または変更します。デフォルトでは、値は 0 (WCF 通信) です。ドメイン参加済み VDA で WebSocket 通信を有効にするには、値をゼロ以外の値に設定します。レジストリを変更した後、変更を適用するために ctxvda サービスを再起動します。

      ヒント:

      作成方法に関係なく、任意のドメイン参加済み VDA で、CbpTransportVersion2 レジストリキーを使用して WCF と WebSocket を切り替えることができます。

VDAとデリバリーコントローラーとの間のWebSocket通信