Services d'infrastructure

Installer les services d'infrastructure

• .\Citrix Workspace Environment Management Infrastructure Services.exe /quiet BrokerLocation="C:\test\Infrastructure Services" /log "C:\test\test.log"
• /quiet BrokerLocation="C:\test\Infrastructure Services" /log "C:\test\test.log"
  • /quiet. Indique le mode silencieux.
  • /log. Indique l'emplacement du fichier journal.
  • BrokerLocation. Indique le chemin d'installation des services d'infrastructure.

Créer un nom de principal de service

• Si vous n'utilisez pas l'authentification Windows ou l'équilibrage de charge, utilisez la commande suivante :
  • setspn -C -S [SPN name] [hostname]
  où hostname est le nom du serveur d'infrastructure.
• Si vous utilisez l'authentification Windows ou l'équilibrage de charge (nécessitant l'authentification Windows), utilisez la commande suivante :
  • setspn -U -S [SPN name] [accountname]
  où accountname est le nom du compte de service qui est utilisé pour l'authentification Windows.
• La valeur par défaut pour [SPN name] est Norskale/BrokerService. Si plusieurs déploiements WEM se trouvent dans la même forêt, vous devrez peut-être configurer plusieurs SPN en ajoutant les valeurs de registre suivantes :
  • setspn -C -S [SPN name] [hostname] ou setspns -U -S [SPN name] [accountname]
  • Pour la machine de l'agent : HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host
  • Pour la machine d'infrastructure et de console : HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Infrastructure Services
  • Nom : AlternativeSPN
  • Type : REG_SZ
  • Valeur : la valeur réelle pour le

Compte de service géré de groupe

1. Si vous disposez déjà d'un gMSA existant, procédez comme suit :
   1. Lie le SPN Citrix WEM au compte à l'aide de la commande suivante :
      • setspn -C -S Norskale/BrokerService [gMSA]$
      où gMSA est le nom du compte gMSA.
   2. Ajoutez les machines pertinentes au compte à l'aide de la commande suivante :
      • Set-ADServiceAccount -Identity [gMSA] -PrincipalsAllowedToRetrieveManagedPassword [hostname]
      où est le nom du serveur d'infrastructure.
2. Si vous n'avez pas de gMSA, accédez à votre contrôleur de domaine, créez-en un, puis liez le SPN Citrix WEM à celui-ci. Utilisez la commande suivante :
   • New-ADServiceAccount [gMSA] -DNSHostName [hostname 1] -PrincipalsAllowedToRetrieveManagedPassword [hostname 2], [hostname 3] -KerberosEncryptionType RC4, AES128, AES256 -ServicePrincipalNames Norskale/BrokerService
   où est le nom du serveur DNS.
   où , sont les noms du serveur d'infrastructure.
   Pour plus d'informations sur la création d'un gMSA, consultez <https://docs.microsoft.com/fr-fr/windows-server/security/group-managed-service-accounts/getting-started-with-group-managed-service-accounts>.
3. Configurer un gMSA manuellement.
   1. Autoriser le compte à accéder à la base de données.
      1. Sur votre serveur SQL principal, accédez à Sécurité > Connexions, cliquez avec le bouton droit sur Connexions, puis sélectionnez Nouvelle connexion.
      2. Dans la fenêtre Connexion - Nouvelle, cliquez sur Rechercher.
      3. Dans la fenêtre Sélectionner un utilisateur ou un groupe, configurez les paramètres comme suit et cliquez sur OK pour quitter la fenêtre.
         • Types d'objets. Sélectionnez uniquement Comptes de service.
         • Emplacements. Sélectionnez Comptes de service gérés.
         • Nom de l'objet. Saisissez le nom du compte que vous avez créé à l'étape 1.
      4. Sur la page Mappage utilisateur, sélectionnez la base de données à laquelle vous souhaitez appliquer le gMSA, puis sélectionnez db-owner comme appartenance au rôle pour la base de données.
      5. Sur la page État, vérifiez que les options Accorder et Activé sont sélectionnées.
      6. Cliquez sur OK pour quitter la fenêtre Connexion - Nouveau.
   2. Utilisez le compte de service que vous avez ajouté pour démarrer le service d'infrastructure Citrix WEM.
      1. Sur votre serveur d'infrastructure, ouvrez le gestionnaire de services Windows, cliquez avec le bouton droit sur le service d'infrastructure Citrix WEM, puis sélectionnez Propriétés.
      2. Sur la page Ouvrir une session, sélectionnez Ce compte, cliquez sur Parcourir, et configurez les paramètres comme décrit dans la troisième sous-étape de l'étape 3.
      3. Cliquez sur OK pour quitter la fenêtre Propriétés du service d'infrastructure Citrix WEM.
      4. Dans le gestionnaire de services Windows, redémarrez le service d'infrastructure Citrix WEM.
      Remarque :
      Vous pouvez également configurer le compte à l'aide de l'interface graphique de WEM. Consultez Créer une base de données WEM et Configurer le service d'infrastructure.

Configurer l'équilibrage de charge

1. Créez un compte de service d'infrastructure Windows pour que le service d'infrastructure WEM se connecte à la base de données WEM.
2. Lorsque vous créez la base de données WEM, sélectionnez l'option Utiliser l'authentification Windows pour la connexion à la base de données du service d'infrastructure et spécifiez le nom du compte de service d'infrastructure. Pour plus d'informations, consultez Créer une base de données Workspace Environment Management.
3. Configurez chaque service d'infrastructure pour se connecter à la base de données SQL en utilisant l'authentification Windows au lieu de l'authentification SQL : sélectionnez l'option Activer l'emprunt d'identité de compte Windows et fournissez les informations d'identification du compte de service d'infrastructure. Pour plus d'informations, consultez Configurer le service d'infrastructure.
4. Configurez les SPN pour les services d'infrastructure WEM afin qu'ils utilisent le nom du compte de service d'infrastructure. Pour plus d'informations, consultez Créer un nom de principal de service.
   Important :
   Décidez d'utiliser un compte de service ou un compte machine avant de déployer un environnement WEM. Une fois qu'un environnement WEM est déjà déployé, vous ne pouvez pas revenir en arrière. Par exemple, si vous souhaitez équilibrer la charge des requêtes entrantes après avoir déjà utilisé le compte machine, vous devez utiliser le compte machine au lieu du compte de service.

5. Créez une adresse IP virtuelle (VIP) qui couvre le nombre de serveurs d'infrastructure que vous souhaitez placer derrière une VIP. Tous les serveurs d'infrastructure couverts par une VIP sont éligibles lorsque les agents se connectent à la VIP.
6. Lorsque vous configurez l'objet de stratégie de groupe (GPO) de configuration de l'hôte d'agent, définissez le paramètre du serveur d'infrastructure sur la VIP au lieu de l'adresse de tout serveur d'infrastructure individuel. Pour plus d'informations, consultez Installer et configurer l'agent.
7. La persistance de session est requise pour la connexion entre les consoles d'administration et le service d'infrastructure. (La persistance de session entre l'agent et le service d'infrastructure n'est pas requise.) Nous vous recommandons de connecter directement chaque console d'administration à un serveur de service d'infrastructure plutôt que d'utiliser la VIP.

Créer une base de données Workspace Environment Management

1. Si l'utilitaire de gestion de base de données n'est pas déjà ouvert, dans le menu Démarrer, sélectionnez Citrix>Workspace Environment Management>WEM Database Management Utility.
   
2. Cliquez sur Créer une base de données, puis sur Suivant.
   
3. Saisissez les informations de base de données suivantes, puis cliquez sur Suivant :
   • Nom du serveur et de l'instance. Adresse du serveur SQL sur lequel la base de données sera hébergée. Cette adresse doit être accessible exactement telle qu'elle est saisie depuis le serveur d'infrastructure. Saisissez le nom du serveur et de l'instance sous forme de nom de machine, de nom de domaine complet ou d'adresse IP. Spécifiez une adresse d'instance complète sous la forme serveraddress,port\\instancename. Si le port n'est pas spécifié, le numéro de port SQL par défaut (1433) est utilisé.
   • Nom de la base de données. Nom de la base de données SQL à créer.
   Remarque :
   Les caractères spéciaux tels que les tirets (-) et les barres obliques (/) ne sont pas autorisés dans le nom de la base de données.
   • Fichier de données : chemin d'accès à l'emplacement du fichier .mdf sur le serveur SQL.
   • Fichier journal : chemin d'accès à l'emplacement du fichier .ldf sur le serveur SQL.
   Remarque :
   L'utilitaire de gestion de base de données ne peut pas interroger votre serveur SQL pour connaître l'emplacement par défaut des fichiers de données et de journal. Ils sont définis par défaut sur les valeurs par défaut d'une installation par défaut de MS SQL Server. Assurez-vous que les valeurs de ces deux champs sont correctes pour votre installation de MS SQL Server, sinon le processus de création de la base de données échouera.
   
4. Fournissez les identifiants du serveur de base de données que l'assistant peut utiliser pour créer la base de données, puis cliquez sur Suivant. Ces identifiants sont indépendants des identifiants que le service d'infrastructure utilise pour se connecter à la base de données après sa création. Ils ne sont pas stockés.
   L'option Utiliser la connexion intégrée est sélectionnée par défaut. Elle permet à l'assistant d'utiliser le compte Windows de l'identité sous laquelle il s'exécute pour se connecter à SQL et créer la base de données. Si ce compte Windows ne dispose pas des autorisations suffisantes pour créer la base de données, vous pouvez soit exécuter l'utilitaire de gestion de base de données en tant que compte Windows disposant des privilèges suffisants, soit désactiver cette option et fournir un compte SQL disposant des privilèges suffisants à la place.
   
5. Entrez les détails de VUEM Administrators et Database Security, puis cliquez sur Suivant. Les informations d’identification que vous fournissez ici sont utilisées par le service d’infrastructure pour se connecter à la base de données après sa création. Elles sont stockées dans la base de données.
   • Groupe d’administrateurs initial. Ce groupe d’utilisateurs est préconfiguré en tant qu’administrateurs Full Access pour la console d’administration. Seuls les utilisateurs configurés en tant qu’administrateurs Workspace Environment Management sont autorisés à utiliser la console d’administration. Spécifiez un groupe d’utilisateurs valide, sinon vous ne pourrez pas utiliser la console d’administration vous-même.
   Remarque :
   Par défaut, LDAP est utilisé lors de la navigation dans le compte. Pour appliquer une communication sécurisée via LDAPS, ajoutez l’entrée de registre suivante :
   • Chemin : HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\WEM
   • Nom : EnableLDAPS
   • Type : REG_SZ
   • Valeur : 1
   • Utiliser l’authentification Windows pour la connexion à la base de données du service d’infrastructure. Lorsque cette option est désactivée (par défaut), la base de données s’attend à ce que le service d’infrastructure s’y connecte à l’aide du compte d’utilisateur SQL vuemUser. Le compte d’utilisateur SQL vuemUser est créé par le processus d’installation. Cela nécessite que l’authentification en mode mixte soit activée pour l’instance SQL.
   Lorsque cette option est sélectionnée, la base de données s’attend à ce que le service d’infrastructure s’y connecte à l’aide d’un compte Windows. Dans ce cas, le compte Windows que vous sélectionnez ne doit pas déjà avoir une connexion sur l’instance SQL. En d’autres termes, vous ne pouvez pas utiliser le même compte Windows pour exécuter le service d’infrastructure que celui que vous avez utilisé pour créer la base de données.
   Pour sélectionner un gMSA, suivez les mêmes étapes que pour la sélection d’un utilisateur AD.
   • Définir le mot de passe du compte d’utilisateur SQL vuemUser. Par défaut, le compte SQL vuemUser est créé avec un mot de passe de 8 caractères qui utilise des lettres majuscules et minuscules, des chiffres et des signes de ponctuation. Sélectionnez cette option si vous souhaitez saisir votre propre mot de passe de compte SQL vuemUser (par exemple, si votre stratégie SQL exige un mot de passe plus complexe).
   Important :
   • Vous devez définir le mot de passe du compte d’utilisateur SQL vuemUser si vous avez l’intention de déployer la base de données Workspace Environment Management dans un groupe de disponibilité SQL Server Always On.
   • Si vous définissez le mot de passe ici, n'oubliez pas de spécifier le même mot de passe lorsque vous configurez le service d'infrastructure.

6. Dans le volet de résumé, vérifiez les paramètres que vous avez sélectionnés, et lorsque vous êtes satisfait, cliquez sur Créer la base de données.
7. Lorsque vous êtes informé que la création de la base de données s'est terminée avec succès, cliquez sur Terminer pour quitter l'assistant.
   Si une erreur se produit lors de la création de la base de données, vérifiez le fichier journal "Citrix WEM Database Management Utility Debug Log.log" dans le dossier Logs sous le répertoire d'installation des services d'infrastructure.

Configurer le service d'infrastructure

1. Dans le menu Démarrer, sélectionnez Citrix > Workspace Environment Management > WEM Infrastructure Service Configuration Utility.
2. Dans l'onglet Paramètres de la base de données, saisissez les détails suivants :
   • Serveur et instance de base de données. Adresse de l'instance SQL Server sur laquelle la base de données Workspace Environment Management est hébergée. Elle doit être accessible exactement telle qu'elle est saisie depuis le serveur d'infrastructure. Spécifiez une adresse d'instance complète comme "serveraddress, port\\instancename". Si le port n'est pas spécifié, le numéro de port SQL par défaut (1433) est utilisé.
   • Serveur et instance de basculement de base de données. Si vous utilisez la mise en miroir de bases de données, spécifiez l'adresse du serveur de basculement ici.
   • Nom de la base de données. Nom de la base de données Workspace Environment Management sur l'instance SQL.
   
3. Dans l'onglet Paramètres réseau, saisissez les ports utilisés par le service d'infrastructure :
   • Port d'administration. Ce port est utilisé par la console d'administration pour se connecter au service d'infrastructure.
   • Port du service d'agent. Ce port est utilisé par vos hôtes d'agent pour se connecter au service d'infrastructure.
   • Port de synchronisation du cache. Ce port est utilisé par le service d'agent pour synchroniser son cache avec le service d'infrastructure.
   • Port de surveillance WEM.
   
4. Dans l'onglet Paramètres avancés, saisissez les paramètres d'emprunt d'identité et d'actualisation automatique.
   • Activer l'emprunt d'identité de compte Windows. Par défaut, cette option est désactivée et le service d'infrastructure utilise l'authentification en mode mixte pour se connecter à la base de données (en utilisant le compte SQL vuemUser créé lors de la création de la base de données). Si vous avez plutôt sélectionné un compte de service d'infrastructure Windows lors de la création de la base de données, vous devez sélectionner cette option et spécifier le même compte Windows pour que le service d'infrastructure l'emprunte lors de la connexion. Le compte que vous sélectionnez doit être un administrateur local sur le serveur d'infrastructure.
     Pour sélectionner un gMSA, suivez les mêmes étapes que pour la sélection d'un utilisateur AD.
   Remarque :
   Par défaut, LDAP est utilisé lors de la navigation dans le compte. Pour appliquer une communication sécurisée via LDAPS, ajoutez l'entrée de registre suivante :
   • Chemin : HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\WEM
   • Nom : EnableLDAPS
   • Type : REG_SZ
   • Valeur : 1
   • Définir le mot de passe du compte utilisateur SQL vuemUser. Vous permet d'informer le service d'infrastructure d'un mot de passe personnalisé configuré pour l'utilisateur SQL vuemUser lors de la création de la base de données. N'activez cette option que si vous avez fourni votre propre mot de passe lors de la création de la base de données.
   • Délai d'actualisation du cache du service d'infrastructure. Durée (en minutes) avant que le service d'infrastructure n'actualise son cache. Le cache est utilisé si le service d'infrastructure ne peut pas se connecter à SQL.
   • Délai de surveillance de l'état SQL du service d'infrastructure. Durée (en secondes) entre chaque tentative du service d'infrastructure d'interroger le serveur SQL.
   • Délai d'expiration de la connexion SQL du service d'infrastructure. Durée (en secondes) pendant laquelle le service d'infrastructure attend lors de la tentative d'établissement d'une connexion avec le serveur SQL avant de mettre fin à la tentative et de générer une erreur.
   • Activer le mode débogage. S'il est activé, le service d'infrastructure est défini en mode de journalisation détaillée.
   • Utiliser le cache même en ligne. S'il est activé, le service d'infrastructure lit toujours les paramètres du site à partir de son cache.
   • Activer l'optimisation des performances. Permet d'optimiser les performances dans les scénarios où le nombre d'agents connectés dépasse un certain seuil (par défaut, 200). Par conséquent, l'agent ou la console d'administration met moins de temps à se connecter au service d'infrastructure.
     • Nombre minimal de threads de travail. Spécifie le nombre minimal de threads de travail que le pool de threads crée à la demande. Définissez le nombre de threads de travail dans la plage de 30 à 3000. Déterminez la valeur en fonction du nombre d'agents connectés. Par défaut, le nombre minimal de threads de travail est de 200.
     • Nombre minimal de threads d'E/S asynchrones. Spécifie le nombre minimal de threads d'E/S asynchrones que le pool de threads crée à la demande. Définissez le nombre de threads d'E/S asynchrones dans la plage de 30 à 3000. Déterminez la valeur en fonction du nombre d'agents connectés. Par défaut, le nombre minimal de threads d'E/S asynchrones est de 200.
   Important :
   Cette fonctionnalité est particulièrement utile lorsque l'agent ou la console d'administration se déconnecte par intermittence du service d'infrastructure.
   Remarque :
   Les valeurs que vous définissez dans les champs Activer l'optimisation des performances sont utilisées lorsque de nouvelles requêtes sont effectuées et avant de passer à un algorithme de gestion de la création et de la destruction des threads. Pour plus d'informations, consultez <https://docs.microsoft.com/fr-fr/dotnet/api/system.threading.threadpool.setminthreads?view=netframework-4.8> et <https://support.microsoft.com/en-sg/help/2538826/wcf-service-may-scale-up-slowly-under-load>.
   • Aider à améliorer Workspace Environment Management à l'aide de Google Analytics. Si cette option est sélectionnée, le service d'infrastructure envoie des analyses anonymes au serveur Google Analytics.
   • Ne pas aider à améliorer Workspace Environment Management à l'aide de Google Analytics. Si cette option est sélectionnée, le service d'infrastructure n'envoie pas d'analyses anonymes au serveur Google Analytics.
   Important :
   À partir de la version 2212, Workspace Environment Management détermine l’option à sélectionner en fonction de la région de la machine hébergeant le service d’infrastructure. Si la machine se trouve dans des régions non européennes, la première option est sélectionnée. Si la machine se trouve dans des régions européennes, la deuxième option est sélectionnée. Ce comportement s’applique uniquement aux nouvelles installations.
   
5. Vous pouvez utiliser l’onglet Maintenance de la base de données pour configurer la maintenance de la base de données.
   • Activer la maintenance planifiée de la base de données. Si ce paramètre est activé, il supprime les anciens enregistrements de statistiques de la base de données à intervalles réguliers.
   • Période de rétention des statistiques. Détermine la durée de conservation des statistiques utilisateur et agent. La valeur par défaut est de 365 jours.
   • Période de rétention de la surveillance du système. Détermine la durée de conservation des statistiques d’optimisation du système. La valeur par défaut est de 90 jours.
   • Période de rétention des enregistrements d’agents. Détermine la durée de conservation des journaux d’enregistrement d’agents dans la base de données. La valeur par défaut est de 1 jour.
   • Heure d’exécution. Détermine l’heure à laquelle l’action de maintenance de la base de données est effectuée. La valeur par défaut est 02:00.
   Conseil
   En tant que bonne pratique, nous vous recommandons d’activer la maintenance planifiée de la base de données pour réduire la taille de la base de données et obtenir les meilleures performances. S’il existe plusieurs services d’infrastructure dans un seul déploiement WEM, activez-le uniquement pour un seul service d’infrastructure.
   
6. Vous pouvez éventuellement utiliser l’onglet Licences pour spécifier un serveur de licences Citrix lors de la configuration du service d’infrastructure. Si vous ne le faites pas, lorsqu’une console d’administration se connecte pour la première fois à une nouvelle base de données Workspace Environment Management, vous devez entrer les informations d’identification du serveur de licences Citrix dans l’onglet À propos du ruban de la console d’administration. Les informations du serveur de licences Citrix sont stockées au même emplacement dans la base de données dans les deux cas.
   • Remplacement global du serveur de licences. Sélectionnez cette option pour spécifier les détails du serveur de licences Citrix pour Workspace Environment Management. Entrez le nom du serveur de licences Citrix, le port du serveur de licences Citrix et le port des services Web pour les licences (également appelé port du service d’activation des licences). Ces paramètres remplacent toutes les informations existantes du serveur de licences Citrix stockées dans la base de données Workspace Environment Management.
     
7. Cliquez sur Enregistrer la configuration pour enregistrer vos paramètres.
8. Pour activer Workspace Environment Management (WEM) à l'aide du service d'activation de licence (LAS), cliquez sur Accepter dans la boîte de dialogue pour approuver son certificat de sécurité.
   Configuration de la licence du service d'infrastructure(/en-us/workspace-environment-management/2607/media/infra-las-cert.png)
   Remarque :
   Si le LAS n'est pas disponible, WEM revient à l'ancien serveur de licences Citrix pour l'activation.