Linux Virtual Delivery Agent

Communication WebSocket entre les VDA et les Delivery Controller

Cet article décrit les étapes permettant d’établir une communication WebSocket entre les VDA et les Delivery Controller, comme alternative à Windows Communication Foundation (WCF).

Étape 1 : activer WebSocket sur les Delivery Controller

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

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

  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 Controller après avoir activé WebSocket.

Étape 2 : activer WebSocket sur les VDA

  1. Installez les autorités de certification (CA) racine et intermédiaires sur les VDA pour faire confiance aux Delivery Controller.

  2. Activer la communication WebSocket pour les VDA en fonction de la méthode de création de VDA :

    • VDA non joints au domaine :

      La communication WebSocket est activée par défaut. Aucune configuration supplémentaire n’est requise.

    • VDA joints au 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 initialement le script d’installation facile (ctxinstall.sh).

      • **CTX_XDL_DJ_ENROLLMENT_TOKEN_FILE= ’** : contrôle l’activation de WebSocket et spécifie le fichier de jeton pour l’enregistrement de VDA. La valeur par défaut est **‘’**, ce qui signifie que WebSocket est désactivé. Pour activer WebSocket sur un VDA joint à un domaine, entrez le chemin d’accès au fichier de jeton.
      • **CTX_XDL_ENROLLMENT_TOOL_USING_LDAPS=’y n’** : configure l’outil d’inscription 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) :

       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:

      Sur n’importe quel 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 Controller