Linux Virtual Delivery Agent

Communication WebSocket entre les VDA et les Delivery Controllers

Cet article décrit les étapes pour établir la communication WebSocket entre les VDA et les Delivery Controllers, en tant qu’alternative à Windows Communication Foundation (WCF).

Étape 1 : Activer WebSocket sur les Delivery Controllers

  1. Configurez votre site. Pour plus d’informations, consultez Créer un site.

  2. Installez les certificats TLS sur chaque Delivery Controller présent sur votre site. Pour plus d’informations, consultez Installer les certificats de serveur TLS sur les Controllers.

  3. Activez la communication WebSocket sur chaque Delivery Controller™ à l’aide de la commande suivante :

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

    Remarque :

    • Assurez-vous de redémarrer les Delivery Controllers après avoir activé WebSocket.

    -  ## Étape 2 : Activer WebSocket sur les VDA
    
  4. Installez les autorités de certification (CA) racine et intermédiaires sur les VDA pour faire confiance aux Delivery Controllers.

  5. Activez la communication WebSocket pour les VDA en fonction de la méthode de création du VDA :

    -  **VDA non joints à un domaine :**
    
    La communication WebSocket est activée par défaut. Aucune configuration supplémentaire n'est requise.
    
    -  **VDA joints à un domaine créés à l'aide de l'installation facile :**
    
    Activez WebSocket en définissant les variables d'environnement suivantes dans `/opt/Citrix/VDA/sbin/ctxinstall.conf` avant d'exécuter le script d'installation facile (ctxinstall.sh) initialement.
    
    -  \*\*CTX\_XDL\_DJ\_ENROLLMENT\_TOKEN\_FILE=<chemin-fichier\>|'<none\>'\*\* – Contrôle l'activation de WebSocket et spécifie le fichier de jeton pour l'enregistrement du VDA. La valeur par défaut est \*\*'<none\>'\*\*, ce qui signifie que WebSocket est désactivé. Pour activer WebSocket sur un VDA joint à un domaine, saisissez le chemin d'accès au fichier de jeton.
    
    -  \*\*CTX\_XDL\_ENROLLMENT\_TOOL\_USING\_LDAPS='y|n'\*\* – Configure l'outil d'enregistrement pour interroger LDAP ou LDAPS. Par défaut, il interroge LDAP \(\*\*'n'\*\*). Pour utiliser LDAPS, définissez la valeur sur \*\*'y'\*\*.
    
    • VDA joints à un domaine créés à l’aide de Machine Creation Services™ (MCS) :

      Sur la machine modèle, ouvrez /etc/xdl/mcs/mcs_local_setting.reg et ajoutez une ligne de commande similaire à la suivante pour l’activation de WebSocket :

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

      Cette commande crée ou modifie la clé de registre CbpTransportVersion2. Par défaut, la valeur est 0 (communication WCF). Pour activer la communication WebSocket sur les VDA joints à un domaine, définissez la valeur sur toute valeur non nulle. Après avoir modifié le registre, redémarrez le service ctxvda pour appliquer les modifications.

      Conseil :

      Sur tout VDA joint à un domaine, quelle que soit sa méthode de création, vous pouvez utiliser la clé de registre CbpTransportVersion2 pour basculer entre WCF et WebSocket.

Communication WebSocket entre les VDA et les Delivery Controllers