Citrix Virtual Apps and Desktops

Installer des VDA à l’aide de SCCM

Vue d’ensemble

Pour déployer correctement 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 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.

Redémarrages

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.

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

Définir la séquence de tâches

Après avoir identifié tous les prérequis et procédé au redémarrage, 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 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.

  • 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 de VDA autre que VDAWorkstationCoreSetup_XXXX.exe, le programme d’installation de VDA est copié dans %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe.
    • Lors de l’utilisation de VDAWorkstationCoreSetup_XXXX.exe, le programme d’installation de VDA est copié dans %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 ait le contrôle du processus d’installation.
    • /NOREBOOT : ne pas redémarrer automatiquement le programme d’installation de VDA. Les déclencheurs SCCM redémarrent en cas de besoin.
    • /NORESUME : en général, 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. Cela représente 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 illustre la séquence d’installation.

  1. TÂCHE SCCM 1 : Préparer la machine en la redémarrant.
  2. TÂCHE SCCM 2 : Démarrer 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 de VDA de votre choix (image locale ou l’un des programmes d’installation minimaux).
    3. 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émarrer la machine, puis passer le contrôle à la TÂCHE SCCM 3.
  3. TÂCHE SCCM 3 : poursuivre l’installation du VDA.
    1. Si la TÂCHE SCCM 2 ne renvoie pas 0 ou 8, l’installation doit être poursuivie une fois le redémarrage terminé.
    2. La TÂCHE SCCM 3 se répète jusqu’à ce que le programme d’installation de VDA renvoie 0 ou 8 (indiquant une installation réussie) ou 3 (indiquant que la TÂCHE SCCM 3 doit être répétée). Tout autre code de retour est traité comme une erreur, et la TÂCHE SCCM 3 doit signaler une erreur et s’arrêter.
    3. Reprendre l’installation du VDA en exécutant le programme d’installation de 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 de VDA utilise les paramètres enregistrés lors de la première exécution du programme d’installation.)
    4. 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émarrer l’ordinateur et répéter la TÂCHE SCCM 3 jusqu’à ce qu’un 0 ou un 8 soit renvoyé. Tout autre code de retour est traité comme une erreur, et la TÂCHE SCCM 3 doit signaler une erreur et s’arrêter.

Pour plus d’informations sur les codes de retour, consultez la section 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 de VDA mono-session principal (VDAWorkstationCoreSetup.exe) :

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

  • La commande suivante utilise le programme d’installation de VDA mono-session complet (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 de VDA mono-session complet (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