Citrix Virtual Apps and Desktops 7 2203 LTSR

Installer des VDA à l’aide de SCCM

Remarque :

Citrix n’est pas responsable des problèmes qui surviennent suite au 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 Citrix lié à l’installation, ouvrez un cas de support technique avec les journaux d’installation pertinents à l’aide du 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 plusieurs é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.
  • Les 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 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 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 : Habituellement, 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 à l’aide de SCCM

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

  1. SCCM TASK1 : Préparez la machine en la redémarrant.
  2. SCCM TASK2 : 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).
    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.
      • Si un code de retour est 3, redémarrez la machine, puis transférez le contrôle à SCCM TASK3.
  3. SCCM TASK3 : Poursuivez l’installation du VDA.
    1. Si SCCM TASK2 ne renvoie pas 0 ou 8, l’installation doit être poursuivie une fois le redémarrage terminé.
    2. SCCM TASK3 se répète jusqu’à ce que le programme d’installation du VDA renvoie 0 ou 8 (indiquant une installation réussie), ou 3 (indiquant que SCCM TASK3 doit être répété). Traitez tout autre code de retour comme une erreur, et SCCM TASK3 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 de l’emplacement où il a été copié (comme décrit dans Définir la séquence de tâches), 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.)
    4. Surveillez le code de retour du programme d’installation du 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 SCCM TASK3 jusqu’à ce qu’un 0 ou 8 soit renvoyé. Traitez tout autre code de retour comme une erreur, et SCCM TASK3 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 PC distant

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

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

  • La commande suivante utilise l’installateur VDA complet pour session unique (VDAWorkstationSetup.exe):

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

Commande d’installation pour VDI dédié

  • La commande suivante utilise l’installateur VDA complet pour 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