Agent

Installer et configurer l’agent

Remarque :

  • N’installez pas l’agent WEM (Workspace Environment Management) sur le serveur d’infrastructure.
  • N’installez pas l’agent WEM et la console d’administration sur la même machine.
  • Si vous avez l’intention d’affecter des ressources publiées dans les magasins Citrix StoreFront en tant que raccourcis d’application dans WEM à partir de la console d’administration, assurez-vous que l’application Citrix Workspace pour Windows est installée sur la console d’administration et sur les machines hôtes de l’agent. Pour de plus amples informations, consultez la section Configuration système requise.

Étape 1 : Configurer les stratégies de groupe (facultatif)

Le cas échéant, vous pouvez choisir de configurer les stratégies de groupe de l’agent à l’aide du modèle d’administration Stratégies de groupe de l’agent. Le package d’installation WEM contient ce modèle. Les fichiers modèles sont divisés en fichiers .admx et fichiers .adml spécifiques à la langue. Nous vous recommandons de configurer les stratégies de groupe sur le contrôleur de domaine.

Pour ajouter la stratégie Configuration de l’hôte de l’agent, procédez comme suit :

  1. Copiez le dossier Stratégies de groupe d’agents fourni avec le package d’installation WEM sur votre contrôleur de domaine WEM.
  2. Ajoutez les fichiers .admx.

    1. Accédez au dossier Stratégies de groupe d’agents > ADMX.
    2. Copiez les deux fichiers (Citrix Workspace Environment Management Agent Host Configuration.admx et CitrixBase.admx).
    3. Accédez au dossier <C:\Windows>\PolicyDefinitions puis collez les fichiers.
  3. Ajoutez les fichiers .adml.

    1. Accédez au dossier Stratégies de groupe d’agents > ADMX > en-US.
    2. Copiez les deux fichiers (Citrix Workspace Environment Management Agent Host Configuration.adml et CitrixBase.adml).
    3. Accédez au dossier <C:\Windows>\PolicyDefinitions\en-US puis collez les fichiers.

Utilisez l’Éditeur de gestion des stratégies de groupe pour configurer un objet de stratégie de groupe avec les paramètres suivants :

Éditeur de gestion de la stratégie

Serveur d’infrastructure. Adresse du serveur d’infrastructure WEM. Tapez le nom ou l’adresse IP de la machine sur laquelle le service d’infrastructure est installé.

Port de service de l’agent. Port sur lequel l’agent se connecte au serveur d’infrastructure. Le port de service de l’agent doit être le même que le port que vous avez configuré pour le port de service de l’agent lors de la configuration des services d’infrastructure. S’il n’est pas spécifié, le port est par défaut 8286.

Port de synchronisation du cache. (Applicable à Workspace Environment Management 1909 et versions antérieures ; remplacé par le port de synchronisation des données mis en cache dans Workspace Environment Management 1912 et versions ultérieures.) Port sur lequel le processus de synchronisation du cache de l’agent se connecte au service d’infrastructure pour synchroniser le cache de l’agent avec le serveur d’infrastructure. Le port de synchronisation du cache doit être le même que le port que vous avez configuré pour le port de synchronisation du cache (Configuration du service d’infrastructure WEM > Paramètres réseau) pendant la configuration des services d’infrastructure. Le port est par défaut 8285 et correspond à l’argument de AgentCacheSyncPort ligne de commande.

Port de synchronisation des données mis en cache. (Applicable à Workspace Environment Management 1912 et versions ultérieures ; remplace le port de synchronisation du cache de Workspace Environment Management 1909 et versions antérieures.) Port sur lequel le processus de synchronisation du cache de l’agent se connecte au service d’infrastructure pour synchroniser le cache de l’agent avec le serveur d’infrastructure. Le port de synchronisation des données mis en cache doit être le même que le port que vous avez configuré pour le port de synchronisation des données mis en cache (Configuration du service d’infrastructure WEM > Paramètres réseau) lors de la configuration des services d’infrastructure. Le port est par défaut 8288 et correspond à l’argument de CachedDataSyncPort ligne de commande. Vous pouvez également spécifier le port à l’aide d’une option de ligne de commande dans l’installation silencieuse de l’agent WEM. Par exemple :

  • citrix_wem_agent_bundle.exe /quiet CachedDataSyncPort=9000

Citrix Cloud Connector. Ne s’applique pas aux versions locales de WEM. Laissez l’état Non configuré.

Configuration proxy de l’agent. Ne s’applique pas aux versions locales de WEM. Laissez l’état Non configuré.

VUEMAppCmd extra sync delay. Spécifie, en millisecondes, combien de temps le lanceur d’applications de l’agent (VUEMAppCmd.exe) attend avant le démarrage des ressources publiées Citrix Virtual Apps and Desktops. Cela garantit que le travail de l’agent nécessaire se termine en premier. La valeur recommandée est de 100 à 200. La valeur par défaut est 0.

Étape 2 : Installer l’agent

Important :

Bien que le .NET Framework puisse être installé automatiquement lors de l’installation de l’agent, nous vous recommandons de l’installer manuellement avant d’installer l’agent. Sinon, vous devez redémarrer votre ordinateur pour poursuivre l’installation de l’agent, et cela peut prendre beaucoup de temps.

Vous pouvez exécuter le programme d’installation de Citrix Workspace Environment Management Agent dans votre environnement utilisateur. Vous pouvez également choisir d’installer l’agent à l’aide de la ligne de commande. Par défaut, l’agent s’installe dans l’un des dossiers suivants, en fonction de votre système d’exploitation :

  • C:\Program Files (x86)\Citrix\Workspace Environment Management Agent (sur le système d’exploitation 64 bits)
  • C:\Program Files\Citrix\Workspace Environment Management Agent (sur le système d’exploitation 32 bits)

Pour installer l’agent de manière interactive, procédez comme suit :

  1. Exécutez Citrix Workspace Environment Management Agent Setup.exe sur votre ordinateur.
  2. Sélectionnez J’accepte les termes et conditions de licence, puis cliquez sur Installer.
  3. Sur la page Bienvenue, cliquez sur Suivant.

    Remarque :

    La page d’accueil peut prendre un certain temps à apparaître. Ce délai se produit lorsque le logiciel requis est manquant et est en cours d’installation en arrière-plan.

  4. Dans la page Dossier de destination, cliquez sur Suivant.

    • Par défaut, le champ du dossier de destination est automatiquement renseigné avec le chemin d’accès au dossier par défaut. Si vous souhaitez installer l’agent dans un autre dossier, cliquez sur Modifier pour accéder au dossier, puis cliquez sur Suivant.
    • Si vous avez déjà installé l’agent WEM, le champ du dossier de destination remplit automatiquement le chemin d’accès au dossier d’installation existant.
  5. Dans la page Type de déploiement, sélectionnez le type de déploiement approprié, puis cliquez sur Suivant. Dans ce cas, sélectionnez Déploiement local.

    Installation de l'agent WEM 01

  6. Dans la page Configuration du service d’infrastructure, spécifiez le service d’infrastructure auquel l’agent se connecte, puis cliquez sur Suivant.

    • Ignorer la configuration. Sélectionnez cette option si vous avez déjà configuré le paramètre à l’aide de la stratégie de groupe.
    • Configurez le service d’infrastructure. Permet de configurer le service d’infrastructure en tapant le nom de domaine complet ou l’adresse IP du service d’infrastructure.
    • Port de service de l’agent. Par défaut, la valeur est 8286.
    • Port de synchronisation des données mis en cache. Par défaut, la valeur est 8288.

    Installation de l'agent WEM 02

  7. Dans la page Paramètres avancés, configurez les paramètres avancés pour l’agent, puis cliquez sur Suivant.

    • Autre emplacement du cache (Facultatif). Permet de spécifier un autre emplacement pour le cache de l’agent. Cliquez sur Parcourir pour accéder au dossier applicable.
    • VUEMAppCmd Extra Sync Delay (facultatif). Permet de spécifier combien de temps le lanceur d’application de l’agent (VUEMAppCmd.exe) attend avant le démarrage des ressources publiées. La définition de ce délai garantit que le travail de l’agent nécessaire se termine en premier. La valeur par défaut est 0.

    Remarque :

    La valeur que vous tapez pour l’intervalle de délai de synchronisation supplémentaire doit être un entier supérieur ou égal à zéro.

    Installation de l'agent WEM 03

  8. Sur la page Prêt à installer, cliquez sur Installer.
  9. Cliquez sur Terminer pour quitter l’assistant d’installation.

Vous pouvez également choisir une installation silencieuse de l’agent WEM. Pour ce faire, utilisez la ligne de commande suivante :

  • "Citrix Workspace Environment Management Agent Setup.exe" /quiet Cloud=0

Conseil :

Vous pouvez consulter les fichiers journaux pour résoudre les problèmes d’installation de l’agent. Par défaut, les fichiers journaux enregistrant toutes les actions qui se produisent pendant l’installation sont créés dans%TEMP%. Vous pouvez utiliser la /log log.txt commande pour désigner un emplacement spécifique pour les fichiers journaux à enregistrer.

Vous pouvez également utiliser les options de ligne de commande pour spécifier des arguments personnalisés. Cela vous permet de personnaliser les paramètres de l’agent et du système pendant le processus d’installation. Pour de plus amples informations, consultez la section À savoir.

Après l’installation, l’agent s’exécute en tant que service hôte de l’agent Citrix WEM (anciennement Service hôte de l’agent Norskale) et Citrix WEM Agent User Logon Service. L’agent s’exécute en tant que compte LocalSystem. Nous ne prenons pas en charge le changement de ce compte. Le service nécessite l’ouverture de session en tant qu’autorisation système local .

Étape 3 : Créer le cache de service de l’agent (facultatif)

Par défaut, le cache du service de l’agent est créé la première fois que l’agent s’exécute. Vous pouvez choisir de créer le cache du service de l’agent avant l’exécution de l’agent. Cela est utile si vous souhaitez créer une image qui inclut l’hôte de l’agent WEM en tant que logiciel préinstallé.

Pour créer ou reconstruire le cache du service de l’agent, exécutez AgentCacheUtility.exe dans le dossier d’installation de l’agent à l’aide de la ligne de commande. L’exécutable accepte les arguments de ligne de commande suivants :

  • -help : affiche la liste des arguments autorisés
  • -refreshcache ou -r : déclenche une génération ou une actualisation du cache

Étape 4 : Redémarrez l’ordinateur pour terminer l’installation

À savoir

L’exécutable de l’agent accepte les arguments personnalisés comme décrit dans les sections Paramètres de l’agent et Paramètres système.

Paramètres de l’agent

Les paramètres de l’agent WEM sont les suivants :

  • AgentLocation. Permet de spécifier l’emplacement d’installation de l’agent. Spécifiez un chemin d’accès à un dossier valide.

  • AgentCacheLocation. Permet de spécifier un autre emplacement pour le cache de l’agent. S’il est configuré, le fichier de cache local de l’agent est enregistré à l’emplacement désigné plutôt que dans le dossier d’installation de l’agent.

  • AgentCacheSyncPort. Permet de spécifier le port sur lequel le processus de synchronisation du cache de l’agent se connecte au service d’infrastructure pour synchroniser le cache de l’agent avec le serveur d’infrastructure.

  • AgentServicePort. Permet de spécifier le port sur lequel l’agent se connecte au serveur d’infrastructure.

  • InfrastructureServer. Permet de spécifier le nom de domaine complet ou l’adresse IP du serveur d’infrastructure sur lequel le service d’infrastructure est exécuté.

  • VUEMAppCmdDelay. Permet de spécifier la durée d’attente du lanceur d’application de l’agent (VUEMAppCmd.exe) avant le démarrage des ressources publiées Citrix Virtual Apps and Desktops. La valeur par défaut est 0 (millisecondes). La valeur que vous tapez pour l’intervalle de délai de synchronisation supplémentaire doit être un entier supérieur ou égal à zéro.

Soyez conscient de ce qui suit :

  • Si vous configurez les paramètres via la ligne de commande, le programme d’installation de l’agent WEM utilise les paramètres configurés.

  • Si vous ne configurez pas les paramètres via la ligne de commande et qu’il existe des paramètres précédemment configurés, le programme d’installation utilise les paramètres précédemment configurés.

  • Si vous ne configurez pas les paramètres via la ligne de commande et qu’il n’existe aucun paramètre précédemment configuré, le programme d’installation utilise les paramètres par défaut.

Paramètres système

Les paramètres système associés à la machine hôte de l’agent sont les suivants :

  • GPNetworkStartTimeoutPolicyValue. Permet de configurer la valeur, en secondes, de la clé de Registre GPNetworkStartTimeoutPolicyValue créée lors de l’installation. Cet argument spécifie la durée pendant laquelle la stratégie de groupe attend les notifications de disponibilité réseau pendant le traitement de la stratégie à l’ouverture de session. L’argument accepte n’importe quel nombre entier compris entre 1 (minimum) et 600 (maximum). Par défaut, cette valeur est 120.

  • SyncForegroundPolicy. Permet de configurer la valeur de Registre SyncForegroundPolicy lors de l’installation de l’agent. Ce paramètre de stratégie détermine si le traitement de la stratégie de groupe est synchrone. Valeurs acceptées : 0, 1. Si la valeur n’est pas définie ou si vous définissez la valeur sur 0, le service d’ouverture de session utilisateur Citrix WEM Agent ne retarde pas les ouvertures de session et les paramètres de stratégie de groupe utilisateur sont traités en arrière-plan. Si vous définissez la valeur sur 1, Citrix WEM Agent User Logon Service retarde les ouvertures de session jusqu’à ce que le traitement des paramètres de stratégie de groupe utilisateur soit terminé. Par défaut, la valeur ne change pas pendant l’installation.

    Important :

    Si les paramètres de stratégie de groupe sont traités en arrière-plan, Windows Shell (Explorateur Windows) peut démarrer avant que tous les paramètres de stratégie ne soient traités. Par conséquent, certains paramètres peuvent ne pas prendre effet la première fois qu’un utilisateur ouvre une session. Si vous souhaitez que tous les paramètres de stratégie soient traités la première fois qu’un utilisateur ouvre une session, définissez la valeur sur 1.

  • WaitForNetwork. Permet de configurer la valeur, en secondes, de la clé de Registre WaitForNetwork créée lors de l’installation. Cet argument spécifie combien de temps l’hôte de l’agent attend que le réseau soit complètement initialisé et disponible. L’argument accepte n’importe quel nombre entier compris entre 0 (minimum) et 300 (maximum). Par défaut, cette valeur est 30.

Les trois clés précédentes garantissent que le service de l’agent WEM démarre avant l’affichage de l’écran d’ouverture de session Windows. Les trois clés sont créées sous HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon pendant l’installation. Les clés garantissent également que l’environnement utilisateur reçoit les objets de stratégie de groupe de l’adresse du serveur d’infrastructure avant l’ouverture de session. Dans les environnements réseau où les serveurs Active Directory ou Contrôleur de domaine sont lents à répondre, un délai de traitement supplémentaire peut se produire avant l’affichage de l’écran d’ouverture de session. Nous vous recommandons de définir la valeur de la clé GPNetworkStartTimeoutPolicyValue sur un minimum de 30 pour qu’elle ait un impact.

  • ServicesPipeTimeout. Permet de configurer la valeur de la clé de Registre ServicesPipeTimeout. La clé est créée lors de l’installation sous HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control. Cette clé de Registre ajoute un délai avant que le gestionnaire de contrôle de service ne soit autorisé à signaler l’état du service d’agent WEM. Le délai empêche l’agent d’échouer en empêchant le service de l’agent de se lancer avant l’initialisation du réseau. Cet argument accepte n’importe quelle valeur, en millisecondes. Si non spécifié, une valeur par défaut de 60000 (60 secondes) est utilisée.

    Remarque :

    Si vous ne configurez pas les paramètres précédents à l’aide de la ligne de commande, le programme d’installation de l’agent WEM ne les traite pas pendant l’installation.

Exemples

Vous pouvez configurer les paramètres à l’aide du format de ligne de commande suivant :

  • "Citrix Workspace Environment Management Agent Setup.exe" <key=value>

Par exemple :

  • Choisissez une installation ou une mise à niveau silencieuse de l’agent WEM
    • "Citrix Workspace Environment Management Agent Setup.exe" /quiet Cloud=0
  • Définir le temps d’attente réseau d’ouverture de session utilisateur sur 60 secondes
    • "Citrix Workspace Environment Management Agent Setup.exe" WaitForNetwork=60
Agent