Documentación de productos
Linux Virtual Delivery Agent
Current Release 2402 LTSR 2311 2308 2305 2303 2301 2212 2210 2209 2207 2206 2204 2203 LTSR 1912 LTSR 7.15 LTSR
Ver PDF

Crear un VDA de Linux no unido a un dominio mediante la instalación sencilla (versión preliminar)

May 7, 2026
Contribución de: 
C C

Este artículo te guía a través del uso de la instalación sencilla para crear un VDA de Linux no unido a un dominio en Citrix DaaS.

Importante:

Paso 1: Crear un catálogo de máquinas

Crea un catálogo de máquinas vacío sin máquinas. Por ejemplo, usa el SDK de PowerShell remoto de Citrix y ejecuta el siguiente comando para crear un catálogo de máquinas vacío llamado Your-catalog-name que admita máquinas con SO de sesión única.

Linux

  • New-BrokerCatalog -AllocationType ‘Static’ -Description ‘Your description’ -MinimumFunctionalLevel ‘L7_20’ -Name ‘Your-catalog-name’ -SessionSupport ‘SingleSession’ -PersistUserChanges ‘OnLocal’ -ProvisioningType ‘Manual’ -MachinesArePhysical $true

  • Guarda un registro del UUID del catálogo creado. El UUID es necesario cuando crees un token de inscripción más adelante. Linux

  • El proceso para crear catálogos de máquinas y agregar máquinas VDA de Linux es similar al enfoque tradicional de VDA de Windows. Para obtener una descripción más detallada de cómo completar estas tareas, consulta Crear catálogos de máquinas y Administrar catálogos de máquinas.

Para crear catálogos de máquinas que contengan máquinas VDA de Linux, hay algunas restricciones que diferencian el proceso de la creación de catálogos de máquinas para VDA de Windows:

  • Para el sistema operativo, selecciona:

  • La opción SO multisesión para un modelo de entrega de escritorio compartido alojado.
    • La opción SO de sesión única para un modelo de entrega de escritorio dedicado VDI.
  • No mezcles máquinas VDA de Linux y Windows en el mismo catálogo de máquinas.
  • No mezcles máquinas unidas a un dominio y no unidas a un dominio en el mismo catálogo de máquinas.
  • Los catálogos de máquinas de acceso con PC remoto solo son compatibles con máquinas unidas a un dominio y no son compatibles con máquinas no unidas a un dominio.

Nota:

Las versiones anteriores de Citrix Studio no admiten el concepto de “SO Linux”. Sin embargo, seleccionar la opción SO de Windows Server o SO de servidor implica un modelo de entrega de escritorios compartidos alojados equivalente. Seleccionar la opción SO de escritorio de Windows o SO de escritorio implica un modelo de entrega de un solo usuario por máquina.

Paso 2: Crear un token de inscripción de VDA

Para crear un VDA no unido a un dominio mediante la instalación sencilla, necesitas un archivo de token para inscribir el VDA en un catálogo de máquinas y autenticar el VDA en el plano de control de Citrix Cloud™. El VDA de Linux no admite el uso de un archivo de token para la inscripción en un catálogo de máquinas administrado por energía.

Para crear un token de inscripción, envía un mensaje HTTP POST similar al siguiente a la URL: [DdcServerAddress]/citrix/orchestration/api/techpreview/{customerid}/{siteid}/enrollments.


    -  POST https://[DdcServerAddress]/citrix/orchestration/api/techpreview/[customerid]/[siteid]/enrollments HTTP/1.1
    -  Accept: application/json
    Content-Type: application/json; charset=utf-8
    Authorization: Bearer <bearer-token>

    {
    "TokenName": "string",
    "IssuedToUser": "string",
    "ExpirationDate": "2023-10-13T08:00:25.796Z",
    "NotValidBeforeDate": "2023-10-13T08:00:25.796Z",
    "NumMachinesAllowed": number,
    "CatalogId": "string"
    }

<!--NeedCopy-->

En el mensaje HTTP POST, establece CatalogId en el UUID del catálogo de máquinas que creaste anteriormente y establece [DdcServerAddress] en una de las siguientes opciones según sea necesario:

  • Comercial https://[customerid].xendesktop.net
  • Japón https://[customerid].apps.citrixworkspacesapi.jp
  • Gobierno https://[customerid].xendesktop.us

Paso 3: Instalar .NET Runtime 6.0

Antes de instalar el VDA de Linux, instala .NET Runtime 6.0 según las instrucciones en https://docs.microsoft.com/en-us/dotnet/core/install/linux-package-managers.

Después de instalar .NET Runtime 6.0, ejecuta el comando which dotnet para encontrar tu ruta de tiempo de ejecución.

Según la salida del comando, establece la ruta binaria del tiempo de ejecución de .NET. Por ejemplo, si la salida del comando es /aa/bb/dotnet, usa /aa/bb como ruta binaria de .NET.

Paso 4: Descargar el paquete VDA de Linux

  1. Ve a la página de descarga de Citrix Virtual Apps and Desktops.
  2. Expande la versión adecuada de Citrix Virtual Apps and Desktops.

  3. Expande Componentes para encontrar el VDA de Linux. Por ejemplo:

    Componentes para Citrix Virtual Apps and Desktops

  4. Haz clic en el enlace del VDA de Linux para acceder a las descargas del VDA de Linux.

    Descargas del VDA de Linux

  5. Descarga el paquete VDA de Linux que coincida con tu distribución de Linux.

  6. Descarga la clave pública GPG que puedes usar para verificar la integridad del paquete VDA de Linux. Por ejemplo:

    Clave pública GPG

    Para verificar la integridad del paquete VDA de Linux mediante la clave pública:

    • Para un paquete RPM, ejecuta los siguientes comandos para importar la clave pública en la base de datos RPM y verificar la integridad del paquete:

      
 rpmkeys --import <path to the public key>
 rpm --checksig --verbose <path to the Linux VDA package>
 <!--NeedCopy-->
      • Para un paquete DEB, ejecuta los siguientes comandos para importar la clave pública en la base de datos DEB y verificar la integridad del paquete:
      
 -  sudo apt-get install dpkg-sig
 -  gpg --import <path to the public key>
 dpkg-sig --verify <path to the Linux VDA package>

 <!--NeedCopy-->

Paso 5: Instalar el paquete VDA de Linux

Para configurar el entorno para el VDA de Linux, ejecuta los siguientes comandos.

  • Para las distribuciones Amazon Linux 2, CentOS, RHEL y Rocky Linux:

  • Nota:

    • Para RHEL y CentOS, instala el repositorio EPEL antes de poder instalar el VDA de Linux correctamente. Para obtener información sobre cómo instalar EPEL, consulta las instrucciones en https://docs.fedoraproject.org/en-US/epel/.

    • Antes de instalar el VDA de Linux en RHEL 9.2/9.0 y Rocky Linux 9.2/9.0, actualiza el paquete libsepol a la versión 3.4 o posterior.


sudo yum  -y localinstall   <PATH>/<Linux VDA RPM>

<!--NeedCopy-->

Nota:

Después de instalar el VDA de Linux en RHEL 8.x/9.x y Rocky Linux 8.x/9.x alojado en GCP, la conexión Ethernet podría perderse y el VDA de Linux podría quedar inaccesible después de reiniciar una VM. Para solucionar el problema, establece una contraseña de root al iniciar sesión en la VM por primera vez y asegúrate de que puedes iniciar sesión en la VM como root. Luego, ejecuta los siguientes comandos en la consola después de reiniciar la VM:

> nmcli dev connect eth0
> systemctl restart NetworkManager
<!--NeedCopy-->

Para distribuciones Ubuntu/Debian:


-  sudo dpkg -i <PATH>/<Linux VDA deb>
-  sudo apt-get install -f

<!--NeedCopy-->

Nota:

-  Para instalar las dependencias necesarias para una distribución Debian 11, agrega la línea `deb http://deb.debian.org/debian/ bullseye main` al archivo /etc/apt/sources.list.

-  Para Ubuntu 20.04 en GCP, deshabilita RDNS. Para ello, agrega la línea **rdns = false** debajo de **[libdefaults]** en /etc/krb5.conf.

Para distribuciones SUSE:

  1. Para SUSE 15.5 en AWS, Azure y GCP, asegúrate de que:

    • Estás usando libstdc++6 versión 12 o posterior.
    • El parámetro Default_WM en /etc/sysconfig/windowmanager esté configurado como “gnome”.
    1. Ejecuta el siguiente comando para instalar el VDA de Linux:

-  zypper -i install <PATH>/<Linux VDA RPM>

<!--NeedCopy-->

Paso 6: Instala los controladores NVIDIA GRID

Habilitar HDX™ 3D Pro requiere que instales los controladores NVIDIA GRID en tu hipervisor y en la máquina VDA.

    -  Para instalar y configurar el Administrador de GPU virtual NVIDIA GRID (el controlador de host) en los hipervisores específicos, consulta las siguientes guías:
    -  [Citrix Hypervisor](/es-es/citrix-hypervisor/graphics/vm-graphics-config.html#install-the-nvidia-drivers)
    -  [VMware ESX](https://docs.nvidia.com/vgpu/latest/grid-software-quick-start-guide/index.html#installing-grid-vgpu-manager-vmware-vsphere)
    -  [Nutanix AHV](https://portal.nutanix.com/page/documents/details?targetId=AHV-Admin-Guide-v5_5:ahv-nvidia-grid-vgpu-host-drivers-install-t.html)

Para instalar y configurar los controladores de VM invitada NVIDIA GRID, realiza los siguientes pasos generales:

  1. Asegúrate de que la VM invitada esté apagada.
  2. En el panel de control del hipervisor, asigna una GPU a la VM.
  3. Inicia la VM.
  4. Instala el controlador de VM invitada en la VM.

Paso 7: Especifica una base de datos para usar

    -  Puedes especificar SQLite o PostgreSQL para usar editando **/etc/xdl/db.conf** después de instalar el paquete VDA de Linux.

Para ello, edita /etc/xdl/db.conf antes de ejecutar sudo /opt/Citrix/VDA/sbin/ctxinstall.sh o /opt/Citrix/VDA/bin/easyinstall.

Nota:

  • Te recomendamos que uses SQLite solo para el modo VDI.
  • Para una instalación fácil y MCS, puedes especificar SQLite o PostgreSQL para usar sin tener que instalarlos manualmente. A menos que se especifique lo contrario a través de /etc/xdl/db.conf, el VDA de Linux usa PostgreSQL por defecto.
  • También puedes usar /etc/xdl/db.conf para configurar el número de puerto para PostgreSQL.

Paso 8: Ejecuta la instalación fácil para configurar el entorno y el VDA para completar la instalación

Después de instalar el paquete VDA de Linux, configura el entorno de ejecución usando el script ctxinstall.sh.

Nota:

Antes de configurar el entorno de ejecución, asegúrate de que la configuración regional en_US.UTF-8 esté instalada en tu sistema operativo. Si la configuración regional no está disponible en tu sistema operativo, ejecuta el comando sudo locale-gen en_US.UTF-8. Para Debian, edita el archivo /etc/locale.gen descomentando la línea # en_US.UTF-8 UTF-8 y luego ejecuta el comando sudo locale-gen.

ctxinstall.sh

ctxinstall.sh es el script de instalación fácil para realizar algunas preconfiguraciones y establecer las variables de entorno de ejecución del VDA.

  • Solo el usuario root puede ejecutar este script.

  • La instalación fácil usa /opt/Citrix/VDA/sbin/ctxinstall.conf como su archivo de configuración para establecer, guardar y sincronizar los valores de todas las variables de entorno usadas. Te recomendamos que leas la plantilla (ctxinstall.conf.tmpl) cuidadosamente y luego personalices tu propio ctxinstall.conf. Cuando crees el archivo de configuración por primera vez, usa cualquiera de las siguientes formas:

    • Copiando el archivo de plantilla /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl y guardándolo como /opt/Citrix/VDA/sbin/ctxinstall.conf.

      • Ejecutando ctxinstall.sh. Cada vez que ejecutas ctxinstall.sh, tu entrada se guarda en /opt/Citrix/VDA/sbin/ctxinstall.conf.

      • La instalación fácil admite la ejecución modular. Los módulos incluyen la verificación previa, la instalación, la configuración de dominio, la configuración y la verificación.

      • Los detalles de depuración para este script se pueden encontrar en /var/log/xdl/ctxinstall.log.

Para obtener más información, usa el comando de ayuda ctxinstall.sh -h.

Nota:

  • Siguiendo el principio de mínimo privilegio, asegúrate de que solo el usuario root pueda leer /opt/Citrix/VDA/sbin/ctxinstall.conf porque la contraseña de unión al dominio podría estar establecida en el archivo.
  • Desinstalar el VDA de Linux quita archivos de /opt/Citrix/VDA. Te recomendamos que hagas una copia de seguridad de /opt/Citrix/VDA/sbin/ctxinstall.conf antes de desinstalar el VDA.

Puedes ejecutar ctxinstall.sh en modo interactivo o silencioso. Antes de ejecutar el script, establece las siguientes variables de entorno:

  • **CTX_XDL_NON_DOMAIN_JOINED=’y|n’** – Si unir la máquina a un dominio. El valor predeterminado es ‘n’. Para escenarios sin unión a dominio, configúralo como ‘y’.

  • CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE=’<path-to-token-file-on-vda-machine>‘ – Para crear un VDA sin unión a dominio usando la instalación fácil, necesitas un archivo de token para inscribir el VDA en un catálogo de máquinas del Delivery Controller. Guarda el token en un archivo con el mínimo privilegio bajo una ruta adecuada.

  • CTX_XDL_VDI_MODE=’y|n’ – Si configurar la máquina como un modelo de entrega de escritorio dedicado (VDI) o un modelo de entrega de escritorio compartido alojado. Para entornos HDX 3D Pro, establece el valor en ‘y’.

  • CTX_XDL_HDX_3D_PRO=’y|n’ – El VDA de Linux admite HDX 3D Pro, un conjunto de tecnologías de aceleración de GPU diseñadas para optimizar la virtualización de aplicaciones gráficas enriquecidas. Si se selecciona HDX 3D Pro, el VDA se configura para el modo de escritorios VDI (sesión única), es decir, CTX_XDL_VDI_MODE=’y’.

  • CTX_XDL_START_SERVICE=’y|n’ – Determina si los servicios del VDA de Linux se inician cuando la configuración está completa.

  • CTX_XDL_REGISTER_SERVICE=’y|n’ – Los servicios de Escritorio virtual de Linux se inician después del arranque de la máquina.

  • CTX_XDL_ADD_FIREWALL_RULES=’y|n’ – Los servicios del VDA de Linux requieren que se permitan las conexiones de red entrantes a través del firewall del sistema. Puedes abrir los puertos requeridos (por defecto, los puertos 80 y 1494) automáticamente en el firewall del sistema para el Escritorio virtual de Linux.

  • CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate – Especifica el entorno de escritorio GNOME, GNOME Classic o MATE para usar en las sesiones. Si dejas la variable sin especificar, se usa el escritorio predeterminado configurado en el VDA.

  • CTX_XDL_DOTNET_RUNTIME_PATH=’<path-to-install-dotnet-runtime\>‘ – La ruta para instalar .NET Runtime 6.0 para admitir el nuevo servicio de agente de broker (ctxvda). La ruta predeterminada es ‘/usr/bin’.

  • CTX_XDL_VDA_PORT=’<port-number\>‘ – El VDA de Linux se comunica con los Delivery Controllers a través de un puerto TCP/IP.

Consideraciones

  • También puedes cambiar el entorno de escritorio para un usuario de sesión de destino completando los siguientes pasos:

    1. Crea un archivo .xsession o .Xclients en el directorio $HOME/<username\> en el VDA. Si estás usando Amazon Linux 2, crea un archivo .Xclients. Si estás usando otras distribuciones, crea un archivo .xsession.

    1. Edita el archivo .xsession o .Xclients para especificar un entorno de escritorio basado en las distribuciones.

      • Para el escritorio MATE

         MSESSION="$(type -p mate-session)"  
 if [ -n "$MSESSION" ]; then  
 exec mate-session  
 fi
 <!--NeedCopy-->

      • Para el escritorio GNOME Classic

         GSESSION="$(type -p gnome-session)"  
 if [ -n "$GSESSION" ]; then  
 export GNOME_SHELL_SESSION_MODE=classic  
 exec gnome-session --session=gnome-classic  
 fi  
 <!--NeedCopy-->

      • Para el escritorio GNOME

         GSESSION="$(type -p gnome-session)"  
 if [ -n "$GSESSION" ]; then  
 exec gnome-session  
 fi  
 <!--NeedCopy-->

    2. Comparte el permiso de archivo 700 con el usuario de la sesión de destino.

    A partir de la versión 2209, los usuarios de la sesión pueden personalizar sus entornos de escritorio. Para habilitar esta función, debes instalar entornos de escritorio intercambiables en el VDA con antelación. Para obtener más información, consulta Entornos de escritorio personalizados por usuarios de sesión.

Modo interactivo

Para ejecutar el script ctxinstall.sh en modo interactivo, usa el comando sudo /opt/Citrix/VDA/sbin/ctxinstall.sh sin la opción -S. Escribe el valor de la variable correspondiente en cada solicitud de la interfaz de línea de comandos. Si una variable ya está configurada, ctxinstall.sh te pedirá confirmación en caso de que quieras cambiarla.

Modo silencioso

En modo silencioso, debes configurar las variables anteriores usando /opt/Citrix/VDA/sbin/ctxinstall.conf o el comando export. Después, ejecuta ctxinstall.sh -S (ten en cuenta que la letra S aquí está en mayúsculas). Si no se configuran todas las variables requeridas o algún valor no es válido, ctxinstall.sh aborta la ejecución, a menos que haya valores predeterminados.

Si lo configuras, el valor exportado para cada variable sobrescribe el valor en /Citrix/VDA/sbin/ctxinstall.conf. Todos los valores actualizados se guardan en /Citrix/VDA/sbin/ctxinstall.conf.


export CTX_XDL_NON_DOMAIN_JOINED='y'
export CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE='<token-file-path>'
export CTX_XDL_VDI_MODE='y|n'
export CTX_XDL_START_SERVICE='y|n'
export CTX_XDL_REGISTER_SERVICE='y|n'
export CTX_XDL_ADD_FIREWALL_RULES='y|n'
export CTX_XDL_HDX_3D_PRO='y|n'
export CTX_XDL_DESKTOP_ENVIRONMENT= gnome | gnome-classic | mate | '<none>'
export CTX_XDL_DOTNET_RUNTIME_PATH='<path-to-install-dotnet-runtime>'
export CTX_XDL_VDA_PORT='<port-number>'
sudo -E /opt/Citrix/VDA/sbin/ctxinstall.sh -S

<!--NeedCopy-->

Al ejecutar el comando sudo, escribe la opción -E para pasar las variables de entorno existentes al nuevo shell que crea. Te recomendamos que crees un archivo de script de shell a partir de los comandos anteriores con #!/bin/bash como primera línea.

Alternativamente, puedes especificar todas las variables usando un solo comando.

Para configurar las variables de entorno de ejecución del VDA (aquellas variables que comienzan con ‘CTX_XDL_’), puedes ejecutar ctxinstall.sh -s (ten en cuenta que la letra s aquí está en minúsculas).

Paso 9: Ejecuta XDPing

Ejecuta sudo /opt/Citrix/VDA/bin/xdping para comprobar si hay problemas de configuración comunes en un entorno de VDA de Linux. Para obtener más información, consulta XDPing.

Paso 10: Ejecuta el VDA de Linux

Inicia el VDA de Linux:

Para iniciar los servicios del VDA de Linux:


sudo systemctl start ctxhdx.service

sudo systemctl start ctxvda.service

<!--NeedCopy-->

Detén el VDA de Linux:

Para detener los servicios del VDA de Linux:


sudo systemctl stop ctxvda.service

sudo systemctl stop ctxhdx.service

<!--NeedCopy-->

Nota:

Antes de detener los servicios ctxvda y ctxhdx, ejecuta el comando systemctl stop ctxmonitord para detener el demonio del servicio de monitorización. De lo contrario, el demonio del servicio de monitorización reiniciará los servicios que detuviste.

Reinicia el VDA de Linux:

Para reiniciar los servicios del VDA de Linux:


sudo systemctl stop ctxvda.service

sudo systemctl restart ctxhdx.service

sudo systemctl start ctxvda.service

<!--NeedCopy-->

Comprueba el estado del VDA de Linux:

Para comprobar el estado de ejecución de los servicios del VDA de Linux:


sudo systemctl status ctxvda.service

sudo systemctl status ctxhdx.service

<!--NeedCopy-->

Paso 11: Crea grupos de entrega

El proceso para crear un grupo de entrega y agregar catálogos de máquinas que contengan máquinas VDA de Linux es casi idéntico al de las máquinas VDA de Windows. Para obtener una descripción más detallada de cómo completar estas tareas, consulta Crear grupos de entrega.

Para crear grupos de entrega que contengan catálogos de máquinas VDA de Linux, se aplican las siguientes restricciones:

  • Asegúrate de que los usuarios y grupos de AD que selecciones se hayan configurado correctamente para iniciar sesión en las máquinas VDA de Linux.
  • No permitas el inicio de sesión de usuarios no autenticados (anónimos).
  • No mezcles el grupo de entrega con catálogos de máquinas que contengan máquinas Windows.

Importante:

La publicación de aplicaciones es compatible con Linux VDA versión 1.4 y posteriores. Sin embargo, el VDA de Linux no admite la entrega de escritorios y aplicaciones a la misma máquina.

Para obtener información sobre cómo crear catálogos de máquinas y grupos de entrega, consulta Citrix Virtual Apps and Desktops 7 2311.

Crear un VDA de Linux no unido a un dominio mediante la instalación sencilla (versión preliminar)
May 7, 2026
Contribución de: 
C C
May 7, 2026
Contribución de: 
C C

En este artículo

Comentarios sobre el sitio | Your privacy choices footer linkSus opciones de privacidad | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.