Installer et configurer

Utilisez la séquence suivante pour configurer votre déploiement de service WEM (Workspace Environment Management). Passez en revue l’ensemble du processus avant de commencer le déploiement afin de savoir à quoi vous attendre. Des liens sont fournis vers la documentation et les vidéos du produit.

Si vous n’êtes pas familier avec les composants et la terminologie utilisés dans un déploiement de service WEM, reportez-vous à la sectionWorkspace Environment Management Service.

Mise en route

Mise en routeen vous inscrivant pour un compte Citrix et en demandant un essai de service WEM.

Configurer les emplacements des ressources et installer Cloud Connectors

Les emplacements de ressources contiennent des serveurs d’infrastructure (tels que Active Directory et Citrix Cloud Connectors) et des machines qui fournissent des applications et des postes de travail aux utilisateurs.

Avant d’installer l’agent WEM, vous devez configurer des emplacements de ressources et installer au moins un Citrix Cloud Connector dans chacun d’eux. Pour une haute disponibilité, Citrix vous recommande d’installer deux Cloud Connectors dans chaque emplacement de ressource.

Voir Emplacements des ressources et Installation de Cloud Connector.

Installer et configurer l’agent WEM

Remarque :

Pour accéder aux ressources publiées dans les magasins Citrix StoreFront sous forme de raccourcis d’application à partir de la console d’administration, assurez-vous que l’application Citrix Workspace pour Windows est installée sur la machine hôte de l’agent. Pour plus d’informations, veuillez consulter Configuration système requise.

Étape 1 : Joindre des machines hôtes de l’agent à AD

Les machines hôtes de l’agent doivent appartenir au même domaine AD que les connecteurs Cloud configurés. Assurez-vous que les machines hôtes de l’agent de chaque emplacement de ressource sont jointes correctement.

Étape 2 : Télécharger l’agent

Téléchargez le package d’agent WEM (Citrix-workspace-environment-management-agent-setup.zip) à partir de l’onglet Téléchargementsdu service WEM et enregistrez une copie sur chaque hôte de l’agent.

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

Le cas échéant, vous pouvez choisir de configurer les stratégies de groupe. Le modèle d’administration de Citrix Workspace Environment Management Agent Host Configuration.admx, fourni dans le package de l’agent, ajoute la stratégie Configuration de l’hôte de l’agent.

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 stratégie de groupe

Serveur d’infrastructure. Non requis pour le service WEM. Laisser l’état « Non configuré ».

Port de service de l’agent. Non requis pour le service WEM. Laisser l’état « Non configuré ».

Port de synchronisation du cache. Non requis pour le service WEM. Laisser l’état « Non configuré ».

Port de synchronisation des données mis en cache. Non requis pour le service WEM. Laisser l’état « Non configuré ».

Connecteurs Citrix Cloud. Configurez au moins un Citrix Cloud Connector. Les machines hôtes de l’agent doivent se trouver dans le même domaine AD que les machines Cloud Connector configurées.

Configuration du proxy de l’agent. L’agent WEM s’appuie sur des connexions Internet pour se connecter au service WEM dans Citrix Cloud. La communication entre l’agent et le service vise les objectifs suivants :

  • Téléchargement de statistiques et d’état vers le service WEM
  • Maintien de la synchronisation du cache de l’agent avec la base de données du service WEM
  • Récupération des paramètres de l’agent et des paramètres WEM spécifiques au jeu de configuration de l’agent

Le cas échéant, vous pouvez choisir de configurer un proxy HTTPS pour définir la façon dont l’agent communique avec le service. Pour ce faire, double-cliquez sur la stratégie de configuration de proxy de l’agent, puis tapez une adresse de serveur proxy. Par exemple, http://10.108.125.51:8080.

VUEMAppCmd extra sync delay. Spécifie 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. Cela garantit que le travail d’agent nécessaire se termine en premier. La valeur par défaut est 0.

Étape 4 : Installer l’agent

Important :

Bien que le .NET Framework puisse être installé automatiquement pendant 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 continuer l’installation de l’agent, et cela peut prendre beaucoup de temps à se terminer.

Le programme d’installation de l’agent Citrix Workspace Environment Management Agent est fourni dans le téléchargement de l’agent. Vous pouvez choisir d’installer l’agent de manière interactive ou à l’aide de la ligne de commande. Par défaut, l’agent s’installe dans l’un des dossiers suivants, selon votre système d’exploitation (OS) :

  • 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 la licence », puis cliquez sur Installer.
  3. Sur la page Bienvenue, cliquez sur Suivant.

    Remarque :

    La page d’accueil peut prendre un certain temps pour s’afficher. Cela 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 du 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 l’agent WEM est déjà installé, le champ du dossier de destination est automatiquement renseigné avec le chemin d’accès du dossier d’installation existant.
  5. Dans la page Type de déploiement, sélectionnez le type de déploiement applicable, puis cliquez sur Suivant. Dans ce cas, sélectionnez Déploiement de service cloud.

    Installation de l'agent WEM 01

  6. Sur la page Configuration du service cloud, spécifiez les connecteurs Citrix Cloud auxquels 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.
    • Configurer Citrix Cloud Connectors. Vous permet de configurer Citrix Cloud Connectors en tapant une liste séparée par des virgules de noms de domaine complets ou d’adresses IP des Cloud Connectors.

    Remarque :

    Tapez le nom de domaine complet ou l’adresse IP de chaque Citrix Cloud Connector. Assurez-vous de séparer les noms de domaine complets ou les adresses IP par des virgules (,).

    Installation de l'agent WEM 02

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

    • Emplacement de cache alternatif (facultatif). Permet de spécifier un emplacement alternatif pour le cache de l’agent. Cliquez sur Parcourir pour accéder au dossier applicable.
    • VUEMAppCmd Extra Sync Delay (facultatif). 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. Cela garantit que le travail d’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 à l’aide de la ligne de commande. Pour ce faire, utilisez la ligne de commande suivante :

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

Vous pouvez également utiliser des 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 À savoir.

Après l’installation, l’agent s’exécute en tant que services suivants : Service hôte de l’agent Citrix WEM et Service d’**ouverture de session utilisateur de l’agent Citrix WEM . L’agent s’exécute en tant que compte LocalSystem. La modification de ce compte n’est pas prise en charge. Les services de l’agent requièrent l’autorisation « Connexion en tant que système local ».

Étape 5 : Générer le cache du 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 de service de l’agent avant l’exécution de l’agent. Ceci 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 de 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 une liste d’arguments autorisés
  • -refreshcache ou -r : déclenche une génération de cache ou une actualisation

Étape 6 : Redémarrez la machine pour terminer l’installation

À savoir

L’exécutable de l’agent accepte les arguments personnalisés comme décrit ci-dessous.

Paramètres de l’agent

Voir ci-dessous pour connaître les paramètres de l’agent WEM.

  • AgentLocation. Permet de spécifier l’emplacement d’installation de l’agent. Vous devez spécifier un chemin d’accès au dossier valide.

  • CloudConnectorList. Permet de spécifier le nom de domaine complet ou l’adresse IP de chaque Citrix Cloud Connector. Assurez-vous de séparer les noms de domaine complets ou les adresses IP par des virgules (,).

  • 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.

  • AgentCacheLocation. Permet de spécifier un emplacement alternatif pour le cache de l’agent. S’il est configuré, le fichier de cache local de l’agent est enregistré à l’emplacement désigné au lieu de dans le dossier d’installation de l’agent.

Soyez conscient des points suivants :

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

  • Si les paramètres ne sont pas configurés 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 les paramètres ne sont pas configurés via la ligne de commande et qu’il n’y a pas de paramètres configurés précédemment, le programme d’installation utilise les paramètres par défaut.

Paramètres système

Voir ci-dessous pour les paramètres système associés à la machine hôte de l’agent.

  • GpNetworkStartTimeoutPolicyValue. Permet de configurer la valeur, en secondes, de la clé de Registre GpNetworkStartTimeoutPolicyValue créée lors de l’installation. Cet argument spécifie combien de temps 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 tout 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 la définissez sur 0, le service d’ouverture de session utilisateur de l’agent Citrix WEM 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 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 la durée pendant laquelle l’hôte de l’agent attend que le réseau soit complètement initialisé et disponible. L’argument accepte tout nombre entier compris entre 0 (minimum) et 300 (maximum). Par défaut, cette valeur est 30.

Les trois clés ci-dessus sont créées sous HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon pendant l’installation. Les clés permettent de s’assurer que l’environnement utilisateur reçoit les objets de stratégie de groupe d’adresse du serveur d’infrastructure avant l’ouverture de session. Dans les environnements réseau où les serveurs Active Directory ou Controller de domaine sont lents à répondre, cela peut entraîner un temps de traitement supplémentaire avant l’affichage de l’écran d’ouverture de session. Citrix recommande 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 soit autorisé à signaler l’état du service d’agent WEM. Ce 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 les paramètres ci-dessus ne sont pas configurés à l’aide de la ligne de commande, ils ne sont pas traités par le programme d’installation de l’agent WEM lors de l’installation.

Exemples

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

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

Par exemple :

  • Spécifier l’emplacement d’installation de l’agent et les connecteurs Citrix Cloud
    • "Citrix Workspace Environment Management Agent Setup.exe" /quiet AgentLocation="L:\WEM Agent" Cloud=1 CloudConnectorList=cc1.qa.local,cc2.qa.local
  • Définir la « durée d’attente du réseau d’ouverture de session utilisateur » à 60 secondes
    • "Citrix Workspace Environment Management Agent Setup.exe" WaitForNetwork=60

Installer et configurer