Installer les VDA avec SCCM
Vue d’ensemble
Microsoft Endpoint Configuration Manager, anciennement System Center Configuration Manager (SCCM), est un produit Windows qui assure la gestion, le déploiement et la sécurité des appareils et des applications au sein d’une entreprise.
Remarque:
L’article suivant décrit uniquement des recommandations basées sur la manière dont Citrix a testé l’environnement. Vous pouvez personnaliser ces étapes en fonction de vos besoins. Citrix n’est pas responsable des mises à jour ou des modifications nécessaires pour répondre aux besoins des clients.
Recommandations
-
Pour déployer correctement un Virtual Delivery Agent (VDA) à l’aide de SCCM ou d’outils de distribution de logiciels semblables, Citrix recommande d’utiliser le programme d’installation VDA en plusieurs étapes.
-
Citrix ne recommande pas d’utiliser l’utilitaire de nettoyage de VDA dans le cadre d’une installation ou d’une mise à niveau de VDA. Utilisez l’utilitaire de nettoyage de VDA uniquement dans le cas où le programme d’installation du VDA a échoué précédemment.
Avant de commencer
Le nombre requis de redémarrages lors de l’installation du VDA dépend de l’environnement. Par exemple:
- Un redémarrage peut être nécessaire pour les mises à jour en attente ou les redémarrages à partir d’installations logicielles antérieures.
- Les fichiers précédemment verrouillés par d’autres processus peuvent nécessiter des mises à jour, ce qui entraîne un redémarrage supplémentaire.
- Certains composants facultatifs du programme d’installation du VDA (tels que le Citrix Profile Management ou Citrix Files) peuvent nécessiter un redémarrage.
- Lors de la mise à niveau d’un VDA, la machine sur laquelle il est installé doit être en mode de maintenance, sans session.
- Lorsqu’une installation de VDA est exécutée pour la première fois sur une machine, le programme d’installation de VDA utilisé est copié sur cette machine. Pour plus d’informations sur l’installation de VDA, consultez la section Programmes d’installation.
SCCM Task Sequencer gère tous les redémarrages requis.
Principales étapes pour déployer un VDA à l’aide de SCCM
Les étapes suivantes décrivent comment déployer un VDA à l’aide de SCCM sur la machine virtuelle.
- Installer le VDA.
- Créer une unité d’organisation (OU).
- Vérifier les machines.
- Utiliser le VDA pour distribuer du contenu.
Étape 1 : installer le VDA
Après avoir identifié tous les logiciels requis, utilisez SCCM Task Sequencer pour effectuer les tâches suivantes :
-
Installez le VDA partir d’une copie accessible du support d’installation ou de l’un des programmes d’installation autonomes de VDA :
VDAWorkstationSetup_XXXX.exe
VDAServerSetup_XXXX.exe
VDAWorkstationCoreSetup_XXXX.exe
Pour plus d’informations sur les programmes d’installation de VDA, consultez la section Programmes d’installation.
Remarque:
Lors de la mise à niveau d’un VDA, la machine sur laquelle il est installé doit être en mode de maintenance, sans session.
- Lorsqu’une installation de VDA est exécutée pour la première fois sur une machine, le programme d’installation de VDA utilisé est copié sur cette machine.
- Lorsque vous utilisez un programme d’installation VDA autre que
VDAWorkstationCoreSetup_XXXX.exe
, le programme d’installation de VDA est copié dans%ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe
. - Lorsque vous utilisez
VDAWorkstationCoreSetup_XXXX.exe
, le programme d’installation de VDA est copié dans%ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.
- Lorsque vous utilisez un programme d’installation VDA autre que
-
L’emplacement du répertoire du programme d’installation de VDA est également stocké dans le registre
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”
. -
Ajoutez les options de ligne de commande
/NOREBOOT
,/NORESUME
et/QUIET
à vos options de ligne de commande.-
/QUIET
: Ne pas afficher l’interface utilisateur pendant l’installation, afin que SCCM ait le contrôle du processus d’installation. -
/NOREBOOT
: Empêche le programme d’installation de VDA de redémarrer automatiquement. Les déclencheurs SCCM redémarrent en cas de besoin. -
/NORESUME
: Généralement, lorsqu’un redémarrage est nécessaire pendant l’installation, le programme d’installation de VDA définit une clé de registre runonce (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce
). Windows utilise la clé pour ouvrir le programme d’installation du VDA lorsque la machine redémarre. Cela représente un problème pour SCCM, car SCCM ne peut pas surveiller l’installation et capturer le code de sortie.
-
Étape 2 : créer une unité d’organisation (UO)
-
Créez deux machines virtuelles jointes à un domaine à ajouter à l’UO. Lorsque les machines virtuelles sont initialement créées, elles se trouvent dans le dossier Ordinateurs. Déplacez les machines virtuelles vers le dossier SCCM. Exemple : WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com
-
Dans Microsoft Configuration Manager, accédez à « \Administration\Vue d’ensemble\Configuration de la hiérarchie\Méthodes de découverte ».
-
Cliquez sur Découverte de systèmes Active Directoryet cochez la case Activer la découverte de systèmes Active Directory pour activer la découverte automatique des machines virtuelles nouvellement créées.
-
Cliquez sur l’icône
pour sélectionner de nouveaux conteneurs.
-
Dans la section Emplacement, ajoutez le Chemin où se trouvent les machines virtuelles SCCM.
-
Accédez à
\Administration\Présentation\Configuration du site\Sites
et cliquez avec le bouton droit sur SCCM VDA. -
Sélectionnez Paramètres d’installation du client > Installation poussée du client. La fenêtre Propriétés de l’installation Push du client s’ouvre.
-
Une fois les VM définies sur
Activées
, vous pouvez voir la liste des VM comme illustré dans les images suivantes. -
Créez une collecte de machine pour créer l’UO. Entrez le Nom du nom de la collection.
-
Suivez les instructions de l’assistant.
L’UO est créée.
-
Ajoutez les machines virtuelles créées à la nouvelle Collection de périphériques.
-
Cliquez avec le bouton droit sur la VM. Sélectionnez Ajouter les éléments sélectionnés > Ajouter les éléments sélectionnés à la collection de périphériques existante.
-
Dans la fenêtre Sélectionner une collection, sélectionnez le nom du périphérique requis. Dans cet exemple, il s’agit de
Devices-SCCM
.
Appareils-SCCM
est répertorié dans Actifs et conformité > Présentation > Collections d’appareils. -
-
Sélectionnez Installer le client sur Device Collector.
-
Sélectionnez le Site d’installation requis.
-
Suivez les instructions de l’assistant. L’assistant d’installation du client Configuration Manager est terminé.
Pour des informations détaillées, consultez Gérer les collections dans la documentation Microsoft.
Étape 3 : vérifier les machines
-
Sur la machine cliente, vérifiez que le client est installé en vérifiant si le processus
CCMExec
est en cours d’exécution. -
Vérifiez si le client fonctionne sur les machines virtuelles sur SCCM.
Étape 4 : utiliser un VDA pour distribuer du contenu
Les étapes suivantes décrivent comment utiliser le VDA déployé pour distribuer du contenu sur les machines virtuelles associées.
Créer un package
-
Pour créer un package, cliquez avec le bouton droit de la souris sur le VDA souhaité, puis cliquez sur Créer un package.
-
Spécifiez l’emplacement des fichiers sources de ce package en cliquant sur Parcourir.
-
Sélectionnez le type de package que vous souhaitez.
-
Entrez le Nom du package et sa Ligne de commandes.
-
Cliquez sur Suivant.
Pour des informations détaillées, consultez Packages et programmes dans Configuration Manager dans la documentation Microsoft.
Distribuer du contenu
-
Cliquez avec le bouton droit sur le nom du package que vous avez créé.
-
Sélectionnez Distribuer du contenu.
-
Dans la fenêtre Assistant de distribution de contenu, sélectionnez l’emplacement des fichiers sources du package que vous avez créé. Dans cet exemple, il s’agit de
2019-SCCM
. Cliquez sur Suivant. -
Vérifiez que le package (dans cet exemple,
Zodiac
) est disponible pour le déploiement.L’image suivante montre que le package est disponible pour le déploiement.
Pour des informations détaillées, consultez Déployer et gérer le contenu pour Configuration Manager dans la documentation Microsoft.
Exemple de séquence d’installation utilisant SCCM
L’exemple suivant illustre la séquence d’installation.
-
Redémarrer l’ordinateur : préparez la machine en la redémarrant.
-
Installer VDA (première tentative) : démarrez l’installation de VDA.
-
Ajoutez les options
/quiet
,/noreboot
et/noresume
à vos options de ligne de commande. -
Exécutez le programme d’installation de VDA de votre choix (image locale ou l’un des programmes d’installation minimaux).
-
SCCM doit saisir le code de retour.
-
Si le code de retour est 0 ou 8, l’installation est terminée et un redémarrage est nécessaire.
-
Si le code de retour est 3, redémarrez la machine, puis passez le contrôle à Installer VDA (deuxième tentative).
-
-
-
Installer VDA (deuxième tentative) : continuez l’installation de VDA.
-
Après Installation de VDA Première tentative si le fichier
%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml
existe, l’installation n’est pas terminée et doit être poursuivie une fois le redémarrage terminé. -
La deuxième tentative d’installation de VDA se répète jusqu’à ce que le fichier
%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml
n’existe pas ou qu’un code de retour autre que 0 ou 8 soit renvoyé. Traitez tout autre code de retour comme une erreur. DEUXIÈME TENTATIVE D’INSTALLATION DU VDA devrait signaler une erreur et s’arrêter. -
Reprenez l’installation de VDA en exécutant le programme d’installation VDA approprié (
XenDesktopVdaSetup.exe
dans la plupart des cas, ouXenDesktopRemotePCSetup.exe
siVDAWorkstationCoreSetup_XXXX.exe
a été utilisé) à partir du répertoire%programdata%\ Citrix\XenDesktopSetup\
sans paramètres de ligne de commande. (Le programme d’installation de VDA utilise les paramètres enregistrés lors de la première exécution du programme d’installation.) -
Surveiller le code de retour du programme d’installation de VDA.
-
0 ou 8 : succès, installation terminée, redémarrage requis.
-
3 : l’installation n’est pas terminée. Redémarrez la machine et répétez INSTALLER VDA DEUXIÈME TENTATIVE jusqu’à ce que le fichier
%programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml
n’existe pas ou jusqu’à ce qu’un 0 ou 8 soit renvoyé. Traitez tout autre code de retour comme une erreur. DEUXIÈME TENTATIVE D’INSTALLATION DU VDA devrait signaler une erreur et se terminer.
-
-
Pour plus d’informations sur les codes de retour, consultez Codes de retour d’installation Citrix.
Exemples de commande d’installation de VDA
Les options d’installation disponibles varient en fonction du programme d’installation utilisé. Consultez les articles suivants pour plus de détails sur les options de ligne de commande.
Commandes d’installation pour Remote PC Access
-
La commande suivante utilise le programme d’installation VDA mono-session (
VDAWorkstationCoreSetup.exe
) :VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot
-
La commande suivante utilise le programme d’installation VDA complet à session unique (
VDAWorkstationSetup.exe
) :VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot
Commande d’installation pour VDI dédié
-
La commande suivante utilise le programme d’installation VDA complet à session unique (
VDAWorkstationSetup.exe
) :VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot