Documentation produit
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
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 un VDA Linux non joint à un domaine dans Citrix DaaS.

Important :

Étape 1 : Créer un catalogue de machines

Créez un catalogue de machines vide, sans aucune machine. Par exemple, utilisez le SDK Citrix Remote PowerShell et exécutez la commande suivante pour créer un catalogue de machines vide nommé Your-catalog-name et prenant en charge les machines OS à session unique.

-  New-BrokerCatalog -AllocationType 'Static' -Description 'Your description' -MinimumFunctionalLevel 'L7_20' -Name 'Your-catalog-name' -SessionSupport 'SingleSession' -PersistUserChanges 'OnLocal' -ProvisioningType 'Manual' -MachinesArePhysical $true
<!--NeedCopy-->

-  Conservez une trace de l'UUID du catalogue créé. L'UUID est nécessaire lorsque vous créez un jeton d'inscription ultérieurement.

-  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](/fr-fr/citrix-virtual-apps-desktops/install-configure/machine-catalogs-create.html) et [Gérer les catalogues de machines](/fr-fr/citrix-virtual-apps-desktops/install-configure/machine-catalogs-manage.html).

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 OS multi-session pour un modèle de livraison de bureau partagé hébergé.
    • L’option OS session unique pour un modèle de livraison de bureau dédié 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 PC distant sont pris en charge uniquement pour les machines jointes à un domaine et ne sont pas pris en charge 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 OS Windows Server ou OS Serveur implique un modèle de livraison de bureaux partagés hébergés équivalent. La sélection de l’option OS Windows Desktop ou OS Desktop implique un modèle de livraison d’un seul utilisateur par machine.

Étape 2 : Créer un jeton d’inscription 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 auprès d’un catalogue de machines et authentifier le VDA auprès du plan de contrôle Citrix Cloud™. 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, envoyez un message HTTP POST similaire à ce qui suit à l’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-->

Dans le message HTTP POST, définissez CatalogId sur l’UUID du catalogue de machines que vous avez créé précédemment et définissez [DdcServerAddress] sur l’une des options suivantes, selon les besoins :

-  Commercial `https://[customerid].xendesktop.net`
  • Japon https://[customerid].apps.citrixworkspacesapi.jp
  • Gouvernement https://[customerid].xendesktop.us

Étape 3 : Installer .NET

Avant d’installer le VDA Linux, installez .NET en fonction de votre distribution Linux :

  • Installez .NET Runtime 8.0 sur toutes les distributions Linux prises en charge, à l’exception de RHEL 7.9 et Amazon Linux 2.
  • Pour RHEL 7.9 et Amazon Linux 2, continuez à installer .NET Runtime 6.0.

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 : 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 5 : Installer le package VDA Linux

  • Pour configurer l’environnement du VDA Linux, 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 VDA Linux 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 VDA Linux sur RHEL 9.3/9.2/9.0 et Rocky Linux 9.3/9.2/9.0, 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 VDA Linux 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 VDA Linux peut être inaccessible après un redémarrage de la VM. Pour contourner le problème, définissez un mot de passe root lors de la première connexion à la VM et assurez-vous que vous pouvez vous connecter à la VM en tant que root. Ensuite, exécutez les commandes suivantes dans la console après avoir redémarré 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 20.04 sur GCP, désactivez le RDNS. Pour ce faire, ajoutez la ligne rdns = false sous [libdefaults] dans /etc/krb5.conf.

Pour les distributions SUSE :

-  1. Pour SUSE 15.5 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 VDA Linux :
     -  zypper -i install <PATH>/<Linux VDA RPM>

 <!--NeedCopy-->

Étape 6 : 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 machine virtuelle invitée NVIDIA GRID, suivez les étapes générales suivantes :

  1. Assurez-vous que la machine virtuelle 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 machine virtuelle invitée (de votre fournisseur de services cloud ou de NVIDIA) sur la VM.

    -  ## Étape 7 : 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 paquet VDA Linux.

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 une 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 VDA Linux utilise PostgreSQL par défaut.
  • Vous pouvez également utiliser /etc/xdl/db.conf pour configurer le numéro de port pour PostgreSQL.

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

Après l’installation du paquet VDA Linux, 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 pour effectuer une pré-configuration et configurer 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 VDA Linux 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=’<path-to-token-file-on-vda-machine>‘ – 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 dans un fichier avec le moindre privilège sous un chemin approprié.

  • 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 VDA Linux 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 bureaux VDI (session unique) - (c’est-à-dire, CTX_XDL_VDI_MODE=’y’).

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

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

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

  • 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 laissez la variable non spécifiée, le bureau par défaut configuré sur le VDA est utilisé.

  • 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 broker (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.

Considérations

  • Vous pouvez également modifier l’environnement de bureau pour un utilisateur de session cible en suivant les étapes ci-dessous :

    1. Créez un fichier .xsession ou .Xclients dans le répertoire $HOME/<username> sur le VDA. Si vous utilisez Amazon Linux 2, créez un fichier .Xclients. Si vous utilisez d’autres distributions, créez un fichier .xsession.

    2. Modifiez le fichier .xsession ou .Xclients pour spécifier un environnement de bureau en fonction des distributions.

      • Pour le bureau MATE

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

      • Pour le bureau 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-->

      • Pour le bureau GNOME

         GSESSION="$(type -p gnome-session)"  
 if [ -n "$GSESSION" ]; then  
 exec gnome-session  
 fi  
 <!--NeedCopy-->
    3. Partagez la permission de fichier 700 avec l’utilisateur de session cible.

    À partir de la version 2209, les utilisateurs de session peuvent personnaliser leurs environnements de bureau. Pour activer cette fonctionnalité, vous devez installer des environnements de bureau commutables sur le VDA à l’avance. Pour plus d’informations, consultez Environnements de bureau personnalisés par les utilisateurs de session.

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 de 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. Ensuite, exécutez ctxinstall.sh -S (notez que la lettre S est ici 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 | 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-->

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 est ici en minuscule).

Étape 9 : 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 10 : 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 11 : 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’accomplir 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 des 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 2402 LTSR.

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.