Documentation produit
Agent de livraison virtuel Linux 2411
Current Release 2402 LTSR 2311 2308 2305 2303 2301 2212 2210 2209 2207 2206 2204 2203 LTSR 1912 LTSR 7.15 LTSR
Voir PDF

Créer un VDA Linux non joint à un domaine à l’aide de l’installation facile (aperçu)

May 5, 2026
Contributeur: 
C C

Cet article vous guide dans l’utilisation de la méthode d’installation facile pour créer et inscrire un VDA Linux non joint à un domaine avec un catalogue de machines dans Citrix DaaS ou Citrix Virtual Apps and Desktops™ 2407 et versions ultérieures.

Important :

Étape 1 : Créer un catalogue de machines vide

  • Connectez-vous à Citrix Web Studio™ et créez un catalogue de machines vide, sans machines. Le VDA Linux ne prend pas en charge l’utilisation d’un fichier de jeton pour l’inscription à un catalogue de machines géré par l’alimentation.

    • Le processus de création de catalogues de machines et d’ajout de machines VDA Linux est similaire à l’approche VDA Windows traditionnelle. Pour une description plus détaillée de la façon d’effectuer ces tâches, consultez Créer des catalogues de machines et Gérer les catalogues de machines.

    • Pour la création de catalogues de machines contenant des machines VDA Linux, il existe quelques restrictions qui différencient le processus de la création de catalogues de machines pour les machines VDA Windows :

  • Pour le système d’exploitation, sélectionnez :

    • L’option Système d’exploitation multi-session pour un modèle de livraison de bureaux partagés hébergés.
  • L’option Système d’exploitation mono-session pour un modèle de livraison de bureaux dédiés VDI.
  • Ne mélangez pas les machines VDA Linux et Windows dans le même catalogue de machines.
  • Ne mélangez pas les machines jointes à un domaine et non jointes à un domaine dans le même catalogue de machines.
    • Les catalogues de machines d’accès au PC distant sont pris en charge uniquement pour les machines jointes à un domaine et ne le sont pas pour les machines non jointes à un domaine.

Remarque :

Les premières versions de Citrix Studio ne prennent pas en charge la notion de « système d’exploitation Linux ». Cependant, la sélection de l’option Système d’exploitation Windows Server ou Système d’exploitation serveur implique un modèle de livraison de bureaux partagés hébergés équivalent. La sélection de l’option Système d’exploitation Windows Desktop ou Système d’exploitation de bureau implique un modèle de livraison d’un seul utilisateur par machine.

Étape 2 : Créer un jeton d’inscription

Pour créer un VDA non joint à un domaine à l’aide de l’installation facile, vous avez besoin d’un fichier de jeton pour inscrire le VDA à un catalogue de machines et authentifier le VDA auprès du contrôleur de livraison cloud ou sur site. Le VDA Linux ne prend pas en charge l’utilisation d’un fichier de jeton pour l’inscription à un catalogue de machines géré par l’alimentation.

Pour créer un jeton d’inscription, suivez les étapes suivantes dans Citrix Web Studio :

Conseil : - > Dans Citrix DaaS, Web Studio est connu sous le nom de Configuration complète.

  1. Sélectionnez le catalogue de machines vide que vous avez créé précédemment, puis sélectionnez Gérer les jetons d’inscription dans la barre d’actions.
    1. Sur la page Gérer les jetons d’inscription, cliquez sur Générer pour créer un jeton d’inscription. Vous pouvez également choisir un jeton existant qui est dans un état valide.

  1. Suivez l’assistant pour compléter les paramètres.

  2. Téléchargez le jeton créé avec succès et enregistrez-le avec le moins de privilèges possible dans un emplacement sécurisé. Plus tard, lorsque vous exécuterez le script d’installation facile, la variable CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE vous permettra de spécifier le chemin d’accès au fichier de jeton pour l’inscription du VDA.

Étape 3 : Installer .NET

En plus du .NET Runtime, vous devez installer .ASP.NET Core Runtime sur toutes les distributions Linux prises en charge avant d’installer ou de mettre à niveau le VDA Linux. La version 6 est requise pour Amazon Linux 2. La version 8 est requise pour les autres distributions.

Si votre distribution Linux contient la version de .NET dont vous avez besoin, installez-la à partir du flux intégré. Sinon, installez .NET à partir du flux de packages Microsoft. Pour plus d’informations, consultez https://docs.microsoft.com/fr-fr/dotnet/core/install/linux-package-managers.

Après avoir installé .NET, exécutez la commande which dotnet pour trouver votre chemin d’exécution.

En fonction de la sortie de la commande, définissez le chemin binaire du runtime .NET. Par exemple, si la sortie de la commande est /aa/bb/dotnet, utilisez /aa/bb comme chemin binaire .NET.

-  ## Étape 4 : Ajouter des certificats d’autorité de certification auto-signés

Pour plus de détails sur la configuration des certificats d’autorité de certification auto-signés, consultez Configurer des certificats auto-signés pour WebSocket. Cette section implique le placement et la mise à jour des certificats d’autorité de certification sur le VDA Linux.

  • Pour RHEL, Rocky Linux et Amazon Linux 2 :

    Enregistrez vos certificats d’autorité de certification auto-signés dans le répertoire /etc/pki/ca-trust/source/anchors sur le VDA Linux, puis exécutez la commande suivante pour mettre à jour les certificats :

     sudo update-ca-trust
 <!--NeedCopy-->

  • Pour SUSE, Ubuntu et Debian :

    Placez le certificat d’autorité de certification racine dans le répertoire /usr/local/share/ca-certificates. Ensuite, exécutez la commande update-ca-certificate.

     sudo update-ca-certificates
 <!--NeedCopy-->

Étape 5 : Télécharger le package VDA Linux

  1. Accédez à la page de téléchargement de Citrix Virtual Apps and Desktops.
  2. Développez la version appropriée de Citrix Virtual Apps™ and Desktops.

  3. Développez Composants pour trouver le VDA Linux. Par exemple :

    Composants pour Citrix Virtual Apps and Desktops

  4. Cliquez sur le lien VDA Linux pour accéder aux téléchargements du VDA Linux.

    Téléchargements du VDA Linux

  5. Téléchargez le package VDA Linux qui correspond à votre distribution Linux.

  6. Téléchargez la clé publique GPG que vous pouvez utiliser pour vérifier l’intégrité du package VDA Linux. Par exemple :

    Clé publique GPG

    Pour vérifier l’intégrité du package VDA Linux à l’aide de la clé publique :

    • Pour un package RPM, exécutez les commandes suivantes pour importer la clé publique dans la base de données RPM et vérifier l’intégrité du package :

      
 -  rpmkeys --import <path to the public key>
 rpm --checksig --verbose <path to the Linux VDA package>

 <!--NeedCopy-->

    • Pour un package DEB, exécutez les commandes suivantes pour importer la clé publique dans la base de données DEB et vérifier l’intégrité du package :

       sudo apt-get install dpkg-sig

 -  gpg --import <path to the public key>
 -  dpkg-sig --verify <path to the Linux VDA package>
 <!--NeedCopy-->

Étape 6 : Installer le package Linux VDA

Pour configurer l’environnement du Linux VDA, exécutez les commandes suivantes.

Pour les distributions Amazon Linux 2, CentOS, RHEL et Rocky Linux :

Remarque :

  • Pour RHEL et CentOS, installez le référentiel EPEL avant de pouvoir installer le Linux VDA avec succès. Pour plus d’informations sur l’installation d’EPEL, consultez les instructions à l’adresse https://docs.fedoraproject.org/en-US/epel/.

  • Avant d’installer le Linux VDA sur RHEL 9.4/9.2 et Rocky Linux 9.4/9.2, mettez à jour le package libsepol vers la version 3.4 ou ultérieure.

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

Remarque :

Après avoir installé le Linux VDA sur RHEL 8.x/9.x et Rocky Linux 8.x/9.x hébergés sur GCP, la connexion Ethernet peut être perdue et le Linux VDA peut devenir inaccessible après un redémarrage de la VM. Pour contourner ce problème, définissez un mot de passe root lors de la première connexion à la VM et assurez-vous de pouvoir vous connecter à la VM en tant que root. Ensuite, exécutez les commandes suivantes dans la console après le redémarrage de la VM :

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

Pour les distributions Ubuntu/Debian :

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

Remarque :

  • Pour installer les dépendances nécessaires pour une distribution Debian 11, ajoutez la ligne deb http://deb.debian.org/debian/ bullseye main au fichier /etc/apt/sources.list.
  • Pour Ubuntu 24.04, 22.04, 20.04 sur GCP, désactivez RDNS. Pour ce faire, ajoutez la ligne rdns = false sous [libdefaults] dans /etc/krb5.conf.

  • Pour les distributions SUSE :

    1. Pour SUSE 15.6 sur AWS, Azure et GCP, assurez-vous que :
    • Vous utilisez libstdc++6 version 12 ou ultérieure.
    • Le paramètre Default_WM dans /etc/sysconfig/windowmanager est défini sur “gnome”.

  1. Exécutez la commande suivante pour installer le Linux VDA :

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

Étape 7 : Installer les pilotes NVIDIA GRID

L’activation de HDX™ 3D Pro nécessite l’installation des pilotes NVIDIA GRID sur votre hyperviseur et sur la machine VDA.

Pour installer et configurer le NVIDIA GRID Virtual GPU Manager (le pilote hôte) sur les hyperviseurs spécifiques, consultez les guides suivants :

Pour installer et configurer les pilotes de VM invitée NVIDIA GRID, effectuez les étapes générales suivantes :

  1. Assurez-vous que la VM invitée est arrêtée.
  2. Dans le panneau de configuration de l’hyperviseur, allouez un GPU à la VM.
  3. Démarrez la VM.
  4. Installez le pilote de VM invitée (fourni par votre fournisseur cloud ou NVIDIA) sur la VM.

Étape 8 : Spécifier une base de données à utiliser

Vous pouvez spécifier SQLite ou PostgreSQL à utiliser en modifiant /etc/xdl/db.conf après l’installation du package Linux VDA.

Pour ce faire, modifiez /etc/xdl/db.conf avant d’exécuter sudo /opt/Citrix/VDA/sbin/ctxinstall.sh ou /opt/Citrix/VDA/bin/easyinstall.

Remarque :

  • Nous vous recommandons d’utiliser SQLite uniquement pour le mode VDI.
  • Pour l’installation facile et MCS, vous pouvez spécifier SQLite ou PostgreSQL à utiliser sans avoir à les installer manuellement. Sauf indication contraire via /etc/xdl/db.conf, le Linux VDA utilise PostgreSQL par défaut.
  • Vous pouvez également utiliser /etc/xdl/db.conf pour configurer le numéro de port de PostgreSQL.

Étape 9 : Exécuter le script d’installation facile pour configurer l’environnement et le VDA afin de terminer l’installation

Après avoir installé le package Linux VDA, configurez l’environnement d’exécution à l’aide du script ctxinstall.sh.

Remarque :

Avant de configurer l’environnement d’exécution, assurez-vous que la locale en_US.UTF-8 est installée dans votre système d’exploitation. Si la locale n’est pas disponible dans votre système d’exploitation, exécutez la commande sudo locale-gen en_US.UTF-8. Pour Debian, modifiez le fichier /etc/locale.gen en décommentant la ligne # en_US.UTF-8 UTF-8, puis exécutez la commande sudo locale-gen.

ctxinstall.sh

ctxinstall.sh est le script d’installation facile permettant d’effectuer une pré-configuration et de définir les variables d’environnement d’exécution du VDA.

  • Seul l’utilisateur root peut exécuter ce script.

  • L’installation facile utilise /opt/Citrix/VDA/sbin/ctxinstall.conf comme fichier de configuration pour définir, enregistrer et synchroniser les valeurs de toutes les variables d’environnement utilisées. Nous vous recommandons de lire attentivement le modèle (ctxinstall.conf.tmpl), puis de personnaliser votre propre ctxinstall.conf. Lorsque vous créez le fichier de configuration pour la première fois, utilisez l’une des méthodes suivantes :
    • En copiant le fichier de modèle /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl et en l’enregistrant sous /opt/Citrix/VDA/sbin/ctxinstall.conf.
    • En exécutant ctxinstall.sh. Chaque fois que vous exécutez ctxinstall.sh, votre saisie est enregistrée dans /opt/Citrix/VDA/sbin/ctxinstall.conf.

  • L’installation facile prend en charge l’exécution modulaire. Les modules incluent la pré-vérification, l’installation, la configuration de domaine, la configuration et la vérification.

  • Les détails de débogage de ce script se trouvent dans /var/log/xdl/ctxinstall.log.

Pour plus d’informations, utilisez la commande d’aide ctxinstall.sh -h.

Remarque :

  • Conformément au principe du moindre privilège, assurez-vous que seul l’utilisateur root peut lire /opt/Citrix/VDA/sbin/ctxinstall.conf, car le mot de passe de jonction de domaine peut être défini dans le fichier.
  • La désinstallation du Linux VDA supprime les fichiers sous /opt/Citrix/VDA. Nous vous recommandons de sauvegarder /opt/Citrix/VDA/sbin/ctxinstall.conf avant de désinstaller le VDA.

Vous pouvez exécuter ctxinstall.sh en mode interactif ou en mode silencieux. Avant d’exécuter le script, définissez les variables d’environnement suivantes :

  • CTX_XDL_NON_DOMAIN_JOINED=’y|n’ – Indique si la machine doit être jointe à un domaine. La valeur par défaut est ‘n’. Pour les scénarios sans jonction de domaine, définissez-la sur ‘y’.

  • CTX_XDL_NDJ_ENROLLMENT_TOKEN_FILE=’<chemin-vers-le-fichier-jeton-sur-la-machine-vda>‘ – Pour créer un VDA non joint à un domaine à l’aide de l’installation facile, vous avez besoin d’un fichier de jeton pour inscrire le VDA dans un catalogue de machines du Delivery Controller. Enregistrez le jeton avec le moins de privilèges possible dans un emplacement sécurisé.

  • CTX_XDL_VDI_MODE=’y|n’ – Indique s’il faut configurer la machine comme un modèle de livraison de bureau dédié (VDI) ou un modèle de livraison de bureau partagé hébergé. Pour les environnements HDX 3D Pro, définissez la valeur sur ‘y’.

  • CTX_XDL_HDX_3D_PRO=’y|n’ – Le Linux VDA prend en charge HDX 3D Pro, un ensemble de technologies d’accélération GPU conçues pour optimiser la virtualisation des applications graphiques riches. Si HDX 3D Pro est sélectionné, le VDA est configuré pour le mode de bureaux VDI (session unique) - (c’est-à-dire, CTX_XDL_VDI_MODE=’y’).

  • CTX_XDL_START_SERVICE=’y|n’ – Détermine si les services Linux VDA sont démarrés une fois la configuration terminée.

  • CTX_XDL_REGISTER_SERVICE=’y|n’ – Les services Linux Virtual Desktop sont démarrés après le démarrage de la machine.

  • CTX_XDL_ADD_FIREWALL_RULES=’y|n’ – Les services Linux VDA nécessitent que les connexions réseau entrantes soient autorisées via le pare-feu système. Vous pouvez ouvrir automatiquement les ports requis (par défaut les ports 80 et 1494) dans le pare-feu système pour le Linux Virtual Desktop.

  • CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/mate – Spécifie l’environnement de bureau GNOME, GNOME Classic ou MATE à utiliser dans les sessions. Si vous ne spécifiez pas la variable, le bureau par défaut configuré sur le VDA est utilisé.

  • CTX_XDL_DESKTOP_ENVIRONMENT=gnome/gnome-classic/kde/mate/xfce/’<none>‘ – Spécifie l’environnement de bureau GNOME, GNOME Classic, KDE, MATE ou Xfce à utiliser dans les sessions. Si vous le définissez sur ‘<none>’, le bureau par défaut configuré sur le VDA est utilisé. Vous pouvez spécifier un environnement de bureau à utiliser dans les sessions à l’aide de la variable CTX_XDL_DESKTOP_ENVIRONMENT. Vous pouvez également basculer entre les environnements de bureau en exécutant des commandes ou en utilisant la barre d’état système. Pour plus d’informations, consultez Commandes de basculement de bureau et Barre d’état système.

  • CTX_XDL_DOTNET_RUNTIME_PATH=’<path-to-install-dotnet-runtime>‘ – Le chemin d’installation de .NET pour prendre en charge le nouveau service d’agent de courtier (ctxvda). Le chemin par défaut est ‘/usr/bin’.

  • CTX_XDL_VDA_PORT=’<port-number>‘ – Le VDA Linux communique avec les Delivery Controllers via un port TCP/IP.

Mode interactif

Pour exécuter le script ctxinstall.sh en mode interactif, utilisez la commande sudo /opt/Citrix/VDA/sbin/ctxinstall.sh sans l’option -S. Saisissez la valeur de variable pertinente à chaque invite dans l’interface de ligne de commande. Si une variable est déjà définie, ctxinstall.sh demande une confirmation au cas où vous souhaiteriez la modifier.

Mode silencieux

En mode silencieux, vous devez définir les variables précédentes à l’aide de /opt/Citrix/VDA/sbin/ctxinstall.conf ou de la commande export. Après cela, exécutez ctxinstall.sh -S (notez que la lettre S ici est en majuscule). Si toutes les variables requises ne sont pas définies ou si une valeur est invalide, ctxinstall.sh interrompt l’exécution, sauf s’il existe des valeurs par défaut.

Si vous la définissez, la valeur exportée pour chaque variable écrase la valeur dans /Citrix/VDA/sbin/ctxinstall.conf. Toutes les valeurs mises à jour sont enregistrées dans /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|kde|mate|xfce|'<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-->

Lorsque vous exécutez la commande sudo, saisissez l’option -E pour transmettre les variables d’environnement existantes au nouveau shell qu’elle crée. Nous vous recommandons de créer un fichier de script shell à partir des commandes précédentes avec #!/bin/bash comme première ligne.

Vous pouvez également spécifier toutes les variables à l’aide d’une seule commande.

Pour configurer les variables d’environnement d’exécution du VDA (les variables commençant par ‘CTX_XDL_’), vous pouvez exécuter ctxinstall.sh -s (notez que la lettre s ici est en minuscule).

Étape 10 : Exécuter XDPing

Exécutez sudo /opt/Citrix/VDA/bin/xdping pour vérifier les problèmes de configuration courants avec un environnement VDA Linux. Pour plus d’informations, consultez XDPing.

Étape 11 : Exécuter le VDA Linux

Démarrer le VDA Linux :

Pour démarrer les services VDA Linux :

sudo systemctl start ctxhdx.service

sudo systemctl start ctxvda.service
<!--NeedCopy-->

Arrêter le VDA Linux :

Pour arrêter les services VDA Linux :

sudo systemctl stop ctxvda.service

sudo systemctl stop ctxhdx.service
<!--NeedCopy-->

Remarque :

Avant d’arrêter les services ctxvda et ctxhdx, exécutez la commande systemctl stop ctxmonitord pour arrêter le démon du service de surveillance. Sinon, le démon du service de surveillance redémarre les services que vous avez arrêtés.

Redémarrer le VDA Linux :

Pour redémarrer les services VDA Linux :

sudo systemctl stop ctxvda.service

sudo systemctl restart ctxhdx.service

sudo systemctl start ctxvda.service
<!--NeedCopy-->

Vérifier l’état du VDA Linux :

Pour vérifier l’état d’exécution des services VDA Linux :

sudo systemctl status ctxvda.service

sudo systemctl status ctxhdx.service
<!--NeedCopy-->

Étape 12 : Créer des groupes de mise à disposition

Le processus de création d’un groupe de mise à disposition et d’ajout de catalogues de machines contenant des machines VDA Linux est presque identique à celui des machines VDA Windows. Pour une description plus détaillée de la façon d’effectuer ces tâches, consultez Créer des groupes de mise à disposition.

Pour la création de groupes de mise à disposition contenant des catalogues de machines VDA Linux, les restrictions suivantes s’appliquent :

  • Assurez-vous que les utilisateurs et groupes AD que vous sélectionnez ont été correctement configurés pour se connecter aux machines VDA Linux.
  • N’autorisez pas la connexion d’utilisateurs non authentifiés (anonymes).
  • Ne mélangez pas le groupe de mise à disposition avec des catalogues de machines contenant des machines Windows.

Important :

La publication d’applications est prise en charge avec le VDA Linux version 1.4 et ultérieure. Cependant, le VDA Linux ne prend pas en charge la mise à disposition de bureaux et d’applications sur la même machine.

Pour plus d’informations sur la création de catalogues de machines et de groupes de mise à disposition, consultez Citrix Virtual Apps and Desktops 7 2407.

Étape 13 : Activer le mappage de comptes locaux

Que se passe-t-il si le mappage de comptes locaux n’est pas activé

Les sessions hébergées sur des VDA non joints à un domaine échouent à la connexion, affichant une invite de mot de passe mais n’acceptant pas le mot de passe correct. Des erreurs similaires à celles-ci peuvent être trouvées dans le fichier hdx.log :

2024-09-25 06:40:30.767979 [LOGIN_BOX:ERROR] <P124211:T58675:S4> citrix-ctxlogin: PamAuthenticate: pam authentication: Authentication failure. Can retry for user 'user3'
2024-09-25 06:40:30.768431 [LOGIN:ERROR] <P124211:T58675:S4> citrix-ctxlogin: LoginBoxValidate: Failed to validate user 'user3'. Due to INVALID_PASSWORD
2024-09-25 06:40:30.768947 [LOGIN_AUTH:INFO] <P124218:T58682:S4> citrix-ctxloginui: CalLabelFormat: Update username label on LoginUI from 'user3' to 'user3' (18)
2024-09-25 06:41:18.766196 [GFX_SLIDER:ERROR] <P124161:T58699:S4> citrix-ctxgfx: GfxCreateSliderListener: Failed to get user home dir.
<!--NeedCopy-->

Activer le mappage de comptes locaux

Pour vous assurer que les utilisateurs peuvent se connecter à un VDA Linux non joint à un domaine, activez le mappage de comptes locaux à l’aide de la commande suivante :

Set-BrokerDesktopGroup -Name "<your delivery group name>" -MachineLogOnType LocalMappedAccount
<!--NeedCopy-->

Pour un déploiement sur site, exécutez la commande directement sur le Delivery Controller. Pour un déploiement Citrix DaaS, exécutez la commande via le SDK PowerShell distant de Citrix Virtual Apps et Desktops.

Créer un VDA Linux non joint à un domaine à l’aide de l’installation facile (aperçu)
May 5, 2026
Contributeur: 
C C
May 5, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.