Linux Virtual Delivery Agent

Comunicación WebSocket entre VDAs y Delivery Controllers

Este artículo describe los pasos para establecer la comunicación WebSocket entre VDAs y Delivery Controllers, como alternativa a Windows Communication Foundation (WCF).

Paso 1: Habilitar WebSocket en los Delivery Controllers

  1. Configura tu sitio. Para obtener más información, consulta Crear un sitio.

  2. Instala certificados TLS en cada Delivery Controller presente en tu sitio. Para obtener más información, consulta Instalar certificados de servidor TLS en los Controllers.

  3. Habilita la comunicación WebSocket en cada Delivery Controller™ mediante el siguiente comando:

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

    Nota:

    • Asegúrate de reiniciar los Delivery Controllers después de habilitar WebSocket.

    -  ## Paso 2: Habilitar WebSocket en los VDAs
    
  4. Instala las entidades de certificación (CA) raíz e intermedias en los VDAs para confiar en los Delivery Controllers.

  5. Habilita la comunicación WebSocket para los VDAs según el método de creación del VDA:

    -  **VDAs no unidos a un dominio**:
    
    La comunicación WebSocket está habilitada de forma predeterminada. No se requiere ninguna configuración adicional.
    
    -  **VDAs unidos a un dominio creados mediante instalación sencilla**:
    
    Habilita WebSocket configurando las siguientes variables de entorno en `/opt/Citrix/VDA/sbin/ctxinstall.conf` antes de ejecutar el script de instalación sencilla (ctxinstall.sh) inicialmente.
    
    -  \*\*CTX\_XDL\_DJ\_ENROLLMENT\_TOKEN\_FILE=<file-path\>|'<none\>'\*\* – Controla la habilitación de WebSocket y especifica el archivo de token para el registro del VDA. El valor predeterminado es \*\*'<none\>'\*\*, lo que significa que WebSocket está deshabilitado. Para habilitar WebSocket en un VDA unido a un dominio, introduce la ruta al archivo de token.
    
    -  \*\*CTX\_XDL\_ENROLLMENT\_TOOL\_USING\_LDAPS='y|n'\*\* – Configura la herramienta de inscripción para consultar LDAP o LDAPS. De forma predeterminada, consulta LDAP \(\*\*'n'\*\*). Para usar LDAPS, establece el valor en \*\*'y'\*\*.
    
    • VDAs unidos a un dominio creados mediante Machine Creation Services™ (MCS):

      En la máquina de plantilla, abre /etc/xdl/mcs/mcs_local_setting.reg y agrega una línea de comando similar a la siguiente para habilitar WebSocket:

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

      Este comando crea o modifica la clave de registro CbpTransportVersion2. De forma predeterminada, el valor es 0 (comunicación WCF). Para habilitar la comunicación WebSocket en los VDAs unidos a un dominio, establece el valor en cualquier valor distinto de cero. Después de modificar el registro, reinicia el servicio ctxvda para aplicar los cambios.

      Sugerencia:

      En cualquier VDA unido a un dominio, independientemente de su método de creación, puedes usar la clave de registro CbpTransportVersion2 para alternar entre WCF y WebSocket.

Comunicación WebSocket entre VDAs y Delivery Controllers