Linux Virtual Delivery Agent

VDAとDelivery Controller間のWebSocket通信

この記事では、Windows Communication Foundation(WCF)の代替として、VDAとDelivery Controller間のWebSocket通信を確立する手順について説明します。

手順1:Delivery ControllerでWebSocketを有効にする

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

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

  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を信頼するには、VDAにルートおよび中間証明機関(CA)をインストールします。

  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’に設定します。
    • Machine Creation Services(MCS)を使用して作成されたドメイン参加済みVDA

       On the template machine, open `/etc/xdl/mcs/mcs_local_setting.reg` and add a command line similar to the following for WebSocket enablement:
      
         create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t "REG_DWORD" -v "CbpTransportVersion2" -d "0x00000001" --force
       <!--NeedCopy-->
      

      This command creates or modifies the CbpTransportVersion2 registry key. By default, the value is 0 (WCF communication). To enable WebSocket communication on domain-joined VDAs, set the value to any non-zero value. After modifying the registry, restart the ctxvda service to apply the changes.

      Tip:

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

VDAとDelivery Controller間のWebSocket通信