Linux Virtual Delivery Agent

VDAsとDelivery Controller間のWebSocket通信

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

ステップ1: Delivery ControllerでのWebSocketの有効化

  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の有効化
    
  4. Delivery Controllerを信頼するために、ルートおよび中間認証局 (CA) をVDAにインストールします。

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

    -  **ドメイン非参加VDA**:
    
    WebSocket通信はデフォルトで有効になっています。追加の構成は不要です。
    
    -  **簡易インストールを使用して作成されたドメイン参加VDA**:
    
    簡易インストールスクリプト (ctxinstall.sh) を最初に実行する前に、`/opt/Citrix/VDA/sbin/ctxinstall.conf` で次の環境変数を設定してWebSocketを有効にします。
    
    -  \*\*CTX\_XDL\_DJ\_ENROLLMENT\_TOKEN\_FILE=<file-path\>|'<none\>'\*\* – WebSocketの有効化を制御し、VDA登録用のトークンファイルを指定します。デフォルト値は \*\*'<none\>'\*\* で、WebSocketが無効であることを意味します。ドメイン参加VDAでWebSocketを有効にするには、トークンファイルへのパスを入力します。
    
    -  \*\*CTX\_XDL\_ENROLLMENT\_TOOL\_USING\_LDAPS='y|n'\*\* – 登録ツールがLDAPまたはLDAPSのどちらを照会するかを構成します。デフォルトではLDAP \(\*\*'n'\*\*) を照会します。LDAPSを使用するには、値を \*\*'y'\*\* に設定します。
    
    • Machine Creation Services™ (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を切り替えることができます。

VDAsとDelivery Controller間のWebSocket通信