Créer un VDA Linux non joint au domaine à l’aide de l’installation facile (aperçu)
Cet article vous explique comment utiliser l’installation facile pour créer un VDA Linux non joint au domaine dans Citrix DaaS.
Important :
- Les VDA non joints au domaine sont pris en charge pour Citrix DaaS.
- Votre plan de contrôle doit être déployé sur Citrix DaaS.
- Vous pouvez déployer des VDA non joints au domaine dans un cloud public ou un centre de données sur site. Les VDA non joints au domaine sont gérés par le plan de contrôle dans Citrix DaaS.
- Pour créer des VDA non joints au domaine, les clients utilisant le service Citrix Gateway doivent s’assurer que Rendezvous V2 est activé. Les Cloud Connectors ne sont requis que si vous prévoyez de provisionner des machines sur des hyperviseurs sur site ou si vous souhaitez utiliser Active Directory comme fournisseur d’identité dans Workspace.
- Pour créer des VDA non joints au domaine, vous pouvez également utiliser MCS. Pour plus d’informations, consultez Créer des VDA Linux non joints au domaine à l’aide de MCS.
- MCS ne prend pas en charge les serveurs bare metal.
- Les fonctionnalités suivantes sont disponibles pour les VDA Linux non joints au domaine :
- [Authentification avec Azure Active Directory]
- Rendezvous V2
Étape 1 : Créer un catalogue de machines
Créez un catalogue de machines vide sans aucune machine. Par exemple, utilisez le SDK PowerShell distant de Citrix et exécutez la commande suivante pour créer un catalogue de machines vide nommé Your-catalog-name qui prend 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 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 traditionnelle des VDA Windows. 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 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 au domaine et non jointes au domaine dans le même catalogue de machines.
- Les catalogues de machines Remote PC Access sont pris en charge uniquement pour les machines jointes au domaine et ne sont pas pris en charge pour les machines non jointes au 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 de bureau Windows ou OS de bureau 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 au 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 auprès d’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 Runtime 6.0
Avant d’installer le VDA Linux, installez .NET Runtime 6.0 conformément aux instructions disponibles à l’adresse https://docs.microsoft.com/en-us/dotnet/core/install/linux-package-managers.
Après avoir installé .NET Runtime 6.0, 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 de .NET runtime. Par exemple, si la sortie de la commande est /aa/bb/dotnet, utilisez /aa/bb comme chemin binaire de .NET.
Étape 4 : Télécharger le package VDA Linux
- Accédez à la page de téléchargement de Citrix Virtual Apps and Desktops.
- Développez la version appropriée de Citrix Virtual Apps and Desktops.
-
Développez Components pour trouver le VDA Linux. Par exemple :
-
Cliquez sur le lien VDA Linux pour accéder aux téléchargements du VDA Linux.
-
Téléchargez le package VDA Linux qui correspond à votre distribution Linux.
-
Téléchargez la clé publique GPG que vous pouvez utiliser pour vérifier l’intégrité du package VDA Linux. Par exemple :
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 pour le 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.2/9.0 et Rocky Linux 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 ce 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 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 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 :
-
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”.
-
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 gestionnaire de GPU virtuel NVIDIA GRID (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, suivez les étapes générales suivantes :
- Assurez-vous que la VM invitée est arrêtée.
- Dans le panneau de configuration de l’hyperviseur, allouez un GPU à la VM.
- Démarrez la VM.
- Installez le pilote de VM invitée 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 package 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 package 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 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 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 vérification préalable, 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.
-
- En copiant le fichier modèle /opt/Citrix/VDA/sbin/ctxinstall.conf.tmpl et en l’enregistrant sous /opt/Citrix/VDA/sbin/ctxinstall.conf.
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 VDA Linux 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 VDA Linux 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 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 Runtime 6.0 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.
Considérations
-
Vous pouvez également modifier l’environnement de bureau pour un utilisateur de session cible en suivant les étapes suivantes :
-
- Créez un fichier
.xsessionou.Xclientssous 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.
- Créez un fichier
-
-
Modifiez le fichier
.xsessionou.Xclientspour spécifier un environnement de bureau basé sur les 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
-
-
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 dans l’interface de ligne de commande. Si une variable est déjà définie, ctxinstall.sh vous 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 annule 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-->
Lors de l’exécution de 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 Linux VDA. Pour plus d’informations, consultez XDPing.
Étape 10 : Exécuter le VDA Linux
Démarrer le VDA Linux :
Pour démarrer les services du VDA Linux :
sudo systemctl start ctxhdx.service
sudo systemctl start ctxvda.service
<!--NeedCopy-->
Arrêter le VDA Linux :
Pour arrêter les services du 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 du 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 du 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 Linux VDA est presque identique à celui des machines Windows VDA. 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 Linux VDA, 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 Linux VDA.
- 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 à partir de la version 1.4 du VDA Linux. 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 2311.
Dans cet article
- Étape 1 : Créer un catalogue de machines
- Étape 2 : Créer un jeton d’inscription VDA
- Étape 3 : Installer .NET Runtime 6.0
- Étape 4 : Télécharger le package VDA Linux
- Étape 5 : Installer le package VDA Linux
- Étape 6 : Installer les pilotes NVIDIA GRID
- Étape 7 : Spécifier une base de données à utiliser
- Étape 8 : Exécuter l’installation facile pour configurer l’environnement et le VDA afin de terminer l’installation
- Étape 9 : Exécuter XDPing
- Étape 10 : Exécuter le VDA Linux
- Étape 11 : Créer des groupes de mise à disposition