Citrix Virtual Apps and Desktops

Installer des VDA à l’aide de SCCM

Remarque :

Citrix n’est pas responsable des problèmes liés 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) qui ont été adaptés pour répondre aux exigences des environnements de production des clients. Pour tout problème lié à l’installation de Citrix, ouvrez un dossier de support technique et ajoutez-y les journaux d’installation correspondants à l’aide du portail de support Citrix.

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. 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 de VDA de votre choix (image locale ou l’un des programmes d’installation minimaux). Première tentative d'installation du VDA
    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. SCCM capture le code de retour
      • Si le code de retour est 3, redémarrez la machine, puis passez 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 différent de 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.
    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 de fichier %programdata%\ Citrix\XenDesktopSetup\ sans aucun paramètre 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.) Mettre à niveau l'éditeur de séquences de tâches
    4. Surveiller le code de retour du programme d’installation de VDA.
      • 0 ou 8 : succès, installation terminée, redémarrage requis. Installation terminée avec succès
      • 3 : l’installation n’est pas terminée. Redémarrez la machine et répétez DEUXIÈME TENTATIVE D’INSTALLATION DU VDA jusqu’à ce que le fichier %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml n’existe plus ou que la valeur 0 ou 8 soit renvoyée. 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 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