Citrix Virtual Apps and Desktops 7 2311

Installer des VDA à l’aide de SCCM

Remarque :

Citrix n’est pas responsable des problèmes survenant lors du déploiement d’un Virtual Delivery Agent (VDA) à l’aide d’outils de distribution de logiciels tels que Microsoft System Center Configuration Manager (SCCM) adaptés aux environnements de production des clients. Pour tout problème d’installation lié à Citrix, ouvrez un dossier de support technique avec les journaux d’installation pertinents via le portail de support Citrix.

Présentation

Pour déployer avec succès un Virtual Delivery Agent (VDA) à l’aide de Microsoft System Center Configuration Manager (SCCM) ou d’outils de distribution de logiciels similaires, Citrix® recommande d’utiliser le programme d’installation du VDA en une séquence d’étapes.

Citrix ne recommande pas d’utiliser l’utilitaire de nettoyage VDA dans le cadre d’une installation ou d’une mise à niveau de VDA. Utilisez l’utilitaire de nettoyage VDA uniquement dans le cas limité où le programme d’installation du VDA a précédemment échoué.

Redémarrages

Le nombre de redémarrages requis 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 d’installations logicielles antérieures.
  • Des fichiers précédemment verrouillés par d’autres processus peuvent nécessiter des mises à jour, forçant un redémarrage supplémentaire.
  • Certains composants facultatifs du programme d’installation du VDA (tels que Citrix Profile Management et Citrix Files) peuvent nécessiter un redémarrage.

Le séquenceur de tâches SCCM gère tous les redémarrages requis.

Définir la séquence de tâches

Après avoir identifié tous les prérequis et les redémarrages, utilisez le séquenceur de tâches SCCM pour effectuer les opérations suivantes :

  • Le VDA peut être installé à partir d’une copie accessible du support d’installation ou à partir de l’un des programmes d’installation autonomes du VDA :

    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_XXXX.exe

    Pour plus d’informations sur les programmes d’installation de VDA, consultez Programmes d’installation.

  • Lors de la mise à niveau d’un VDA, la machine sur laquelle il est installé doit être en mode maintenance, sans aucune session.
  • Lorsqu’une installation de VDA s’exécute 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 de VDA autre que VDAWorkstationCoreSetup_XXXX.exe, le programme d’installation de VDA est copié vers %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Lorsque vous utilisez VDAWorkstationCoreSetup_XXXX.exe, le programme d’installation de VDA est copié vers %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe. `
  • 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 contrôle le processus d’installation.
    • /NOREBOOT: Empêcher le programme d’installation de VDA de redémarrer automatiquement. SCCM déclenche les redémarrages si nécessaire.
    • /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). Lorsque la machine redémarre, Windows utilise la clé pour lancer le programme d’installation de VDA. C’est un problème pour SCCM, car SCCM ne peut pas surveiller l’installation et capturer le code de sortie.

Exemple de séquence d’installation utilisant SCCM

L’exemple suivant montre la séquence d’installation.

  1. Redémarrer l’ordinateur : Préparez la machine en la redémarrant. Redémarrer l'ordinateur
  2. Première tentative d’installation du VDA : Démarrez l’installation du VDA.
    1. Ajoutez les options /quiet, /noreboot et /noresume à vos options de ligne de commande.
    2. Exécutez le programme d’installation du VDA de votre choix (image locale ou l’un des programmes d’installation minimaux). Première tentative d'installation du VDA
    3. SCCM doit capturer 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. SCCM capture le code de retour
      • Si un code de retour est 3, redémarrez la machine, puis transférez le contrôle à Deuxième tentative d’installation du VDA. Redémarrer la machine
  3. Deuxième tentative d’installation du VDA : Poursuivez l’installation du VDA.
    1. Après la Première tentative d’installation du VDA, 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é. Deuxième tentative d'installation du VDA
    2. La Deuxième tentative d’installation du VDA se répète jusqu’à ce que le fichier %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml n’existe plus ou qu’un code de retour autre que 0 ou 8 soit renvoyé. Considérez tout autre code de retour comme une erreur, et la DEUXIÈME TENTATIVE D’INSTALLATION DU VDA doit signaler une erreur et s’arrêter.
    3. Reprenez l’installation du VDA en exécutant le programme d’installation du VDA approprié (XenDesktopVdaSetup.exe dans la plupart des cas, ou XenDesktopRemotePCSetup.exe si VDAWorkstationCoreSetup_XXXX.exe a été utilisé) à partir du répertoire du fichier %programdata%\ Citrix\XenDesktopSetup\ sans paramètres de ligne de commande. (Le programme d’installation du VDA utilise les paramètres qu’il a enregistrés lors de la première exécution du programme d’installation.) Éditeur de séquence de tâches de mise à niveau
    4. Surveillez le code de retour du programme d’installation du VDA.
      • 0 ou 8 : Succès, installation terminée, redémarrage requis. Installation réussie terminée
      • 3 : L’installation n’est pas terminée. Redémarrez la machine et répétez la DEUXIÈME TENTATIVE D’INSTALLATION DU VDA jusqu’à ce que le fichier %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml n’existe plus ou qu’un 0 ou 8 soit renvoyé. Considérez tout autre code de retour comme une erreur, et la DEUXIÈME TENTATIVE D’INSTALLATION DU VDA doit signaler une erreur et se terminer.

Pour plus d’informations sur les codes de retour, consultez codes de retour d’installation Citrix.

Exemples de commandes d’installation de VDA

Les options d’installation disponibles varient en fonction de l’installateur utilisé. Consultez les articles suivants pour plus de détails sur les options de ligne de commande.

Commandes d’installation pour l’accès au PC distant

  • La commande suivante utilise l’installateur VDA principal à session unique (VDAWorkstationCoreSetup.exe):

    VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

  • La commande suivante utilise l’installateur 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 l’installateur VDA complet à session unique (VDAWorkstationSetup.exe):

    VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot

Installer des VDA à l’aide de SCCM