Installer l’agent App Layering
L’agent App Layering permet à l’appliance ou à une machine de packaging d’exécuter des commandes PowerShell localement. Si vous fournissez les informations d’identification appropriées, l’agent peut exécuter des commandes PowerShell en tant qu’utilisateur spécifique.
Quand l’agent est requis
L’agent App Layering est requis si vous prévoyez de :
- Lancer des scripts à l’aide de vos configurations de connecteur.
- Exécuter l’appliance App Layering dans Microsoft Hyper-V.
- Publier des images en couches sur Citrix Provisioning.
Vous installez l’agent aux emplacements suivants :
- Sur tous les serveurs Hyper-V que vous prévoyez d’utiliser pour la création de couches ou la publication d’images.
- Sur tous les serveurs Citrix Provisioning où vous prévoyez de publier des images en couches.
- Aux emplacements où vos configurations de connecteur exécutent des scripts PowerShell.
Enregistrer l’agent auprès de l’appliance
Le programme d’installation de l’agent App Layering vous invite à enregistrer l’agent auprès d’une appliance App Layering. Si vous n’enregistrez pas l’agent pendant l’installation, vous pouvez l’enregistrer manuellement plus tard. Cependant, les scripts PowerShell ne s’exécutent pas tant que l’agent n’est pas enregistré auprès de l’appliance.
Prérequis
Avant d’installer l’agent App Layering, assurez-vous que le système sur lequel vous installez l’agent répond aux exigences suivantes :
- Un compte avec des privilèges d’administrateur
- .NET 4.5
- PowerShell 3.0 ou version ultérieure
- Snap-in PowerShell. Avant d’utiliser l’agent App Layering sur un serveur Citrix Provisioning Services, vous devez vous assurer que le snap-in PowerShell est installé. Consultez les étapes pour enregistrer manuellement l’agent auprès de l’appliance.
Si vous avez déjà installé l’agent App Layering, vous pouvez télécharger les versions mises à jour depuis la page de téléchargements de Citrix®. Le package d’installation de l’agent est inclus dans le téléchargement ZIP d’App Layering.
Pour télécharger l’agent App Layering
- Accédez à la page d’accueil de Citrix, puis cliquez sur Se connecter.
- Cliquez sur Téléchargements et sélectionnez Citrix App Layering™ dans la liste.
- Sur la page Citrix App Layering, sous Citrix App Layering > Logiciel produit, cliquez sur Citrix App Layering.
- En bas de la page, cliquez sur Outils.
- Cliquez sur Télécharger le fichier de l’agent Citrix App Layering. Le fichier citrix_app_layering_agent_installer.exe est téléchargé sur votre ordinateur.
Installer l’agent App Layering
Le programme d’installation de l’agent App Layering vous invite à enregistrer l’agent auprès d’une appliance App Layering. Si vous n’enregistrez pas l’agent pendant l’installation, vous pouvez l’enregistrer manuellement plus tard. Cependant, gardez à l’esprit que l’agent doit être enregistré auprès de l’appliance avant que les scripts PowerShell ne puissent s’exécuter.
-
À l’aide d’un compte disposant de privilèges d’administrateur, connectez-vous au système sur lequel vous installez l’agent.
-
Copiez le fichier Citrix_app_layering_agent_installer.exe à un emplacement pratique sur le serveur.
-
Exécutez le fichier Citrix_app_layering_agent_installer.exe en tant qu’administrateur et, lorsque vous y êtes invité, entrez le chemin d’accès au répertoire où vous souhaitez installer l’agent App Layering. L’emplacement par défaut est C:\Program Files (x86)\Citrix\Agent.
Le programme d’installation de l’agent vérifie que tous les prérequis sont présents. Si des prérequis sont manquants, le programme d’installation le signale et se ferme sans installer.
-
Le programme d’installation vous demande un numéro de port d’agent. Vous pouvez accepter le numéro de port par défaut (8016) ou en spécifier un autre si le port par défaut est déjà utilisé.
-
Le programme d’installation vous demande les informations d’identification (adresse, nom d’utilisateur et mot de passe) de votre appliance App Layering. Enregistrez l’agent App Layering auprès de l’appliance en saisissant l’adresse IP et les informations d’identification de connexion d’un utilisateur de la console de gestion sur l’appliance avec des privilèges d’administrateur (par exemple, les informations d’identification que vous utilisez pour vous connecter à la console de gestion).
Remarque :
Si l’appliance App Layering n’est pas disponible ou si vous choisissez de ne pas l’enregistrer maintenant, vous pouvez l’enregistrer manuellement plus tard en utilisant la procédure décrite dans Enregistrer manuellement l’agent App Layering auprès de l’appliance.
-
Cliquez sur Terminer pour quitter l’assistant.
Enregistrer manuellement l’agent App Layering auprès de l’appliance
Enregistrez l’agent App Layering auprès de l’appliance.
Si l’agent App Layering n’est pas enregistré auprès d’une appliance App Layering pendant l’installation, vous pouvez l’enregistrer plus tard en utilisant la procédure suivante.
-
En tant qu’administrateur, connectez-vous au serveur où vous avez installé l’agent App Layering.
-
Ouvrez une fenêtre de commande (cmd.exe) en tant qu’administrateur et accédez au répertoire où l’agent App Layering est installé. L’emplacement par défaut est C:\Program Files (x86)\Citrix\Agent.
-
Exécutez la commande PowerShell suivante :
Enable-PSRemoting <!--NeedCopy--> -
Vérifiez que le port 8016 est ouvert en exécutant cette commande :
netstat -a <!--NeedCopy--> -
Ouvrez une fenêtre de commande (cmd.exe) en tant qu’administrateur et accédez au répertoire où l’agent App Layering est installé. L’emplacement par défaut est :
C:\Program Files (x86)\Citrix\Agent <!--NeedCopy--> -
Exécutez la commande suivante, en utilisant l’adresse IP de l’appliance là où indiqué :
Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator <!--NeedCopy--> -
Lorsque vous y êtes invité, entrez le mot de passe d’un utilisateur disposant de privilèges d’administrateur dans la console de gestion de l’appliance.
-
Lorsque le processus d’enregistrement est terminé, un message apparaît vous informant du succès de l’opération. L’enregistrement de l’agent App Layering apparaît dans le journal d’audit du service de gestion.
Si le processus échoue, examinez le fichier journal de l’agent dans le répertoire d’installation :
C:\Program Files (x86)\Citrix\agent\Logs\applayering.agent.log
Vous pouvez également consulter l’aide pour les options de ligne de commande de l’agent App Layering en exécutant la commande suivante :
Citrix.AppLayering.Agent.Service.exe /? <!--NeedCopy--> -
Exécutez la commande PowerShell pour charger les fichiers DLL appropriés sur le serveur Citrix Provisioning.
Pour PVS 7.7 et versions ultérieures :
-
Accédez à :
C:\program files\citrix\provisioning services console <!--NeedCopy--> -
Exécutez la commande :
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll <!--NeedCopy-->
Pour PVS 7.1–7.6 :
-
Accédez à :
C:\program files\citrix\provisioning services console <!--NeedCopy--> -
Exécutez la commande :
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll <!--NeedCopy-->
Au cas où certains snap-ins Citrix Provisioning et Broker seraient désenregistrés, par exemple après une mise à jour majeure de Windows, identifiez-les.
-
-
Exécutez la commande suivante pour lister les snap-ins enregistrés :
get-pssnapin -registered <!--NeedCopy--> -
Consultez cet article pour obtenir des instructions sur la réinscription de tous les snap-ins.