Résolution des problèmes de StoreFront
Journaux d’installation
Lorsque StoreFront est installé ou désinstallé, les fichiers journaux suivants sont créés par le programme d’installation de StoreFront dans le répertoire C:\Windows\Temp\StoreFront. Les noms des fichiers reflètent les composants qui les ont créés et incluent des horodatages.
- Citrix-DeliveryServicesRoleManager-*.log : créé lorsque StoreFront est installé de manière interactive.
- Citrix-DeliveryServicesSetupConsole-*.log : créé lorsque StoreFront est installé en mode silencieux et lorsque StoreFront est désinstallé de manière interactive ou silencieuse.
- CitrixMsi-CitrixStoreFront-x64-*.log : créé lorsque StoreFront est installé et désinstallé, de manière interactive ou silencieuse.
Journaux d’événements
StoreFront prend en charge la journalisation d’événements Windows pour le service d’authentification, les magasins et les sites Receiver pour Web. Tous les événements générés sont journalisés dans le journal des applications de StoreFront, qui peut être consulté à l’aide de l’Observateur d’événements accessible dans Journaux des applications et des services > Citrix Delivery Services ou dans Journaux Windows > Application. Vous pouvez contrôler le nombre des doublons d’entrées du journal pour un événement unique en modifiant les fichiers de configuration du service d’authentification, des magasins et des sites Receiver pour Web.
Limitation des événements consignés dans le journal
-
Utilisez un éditeur de texte pour ouvrir le fichier web.config du service d’authentification, du magasin ou du site Receiver pour Web, qui se trouve en général dans les répertoires C:\inetpub\wwwroot\Citrix\Authentication, C:\inetpub\wwwroot\Citrix\nommagasin et C:\inetpub\wwwroot\Citrix\nommagasinWeb\, où nommagasin désigne le nom indiqué pour le magasin au moment de sa création.
-
Recherchez l’élément suivant dans le fichier.
<logger duplicateInterval="00:01:00" duplicateLimit="10">Par défaut, StoreFront est configuré pour limiter le nombre de doublons d’entrées du journal à 10 par minute.
-
Modifiez la valeur de l’attribut duplicateInterval sur la durée définie en heures, minutes et secondes pendant laquelle les doublons d’entrées du journal seront analysés. Utilisez l’attribut duplicateLimit pour définir le nombre de doublons d’entrées devant être consignés dans l’intervalle spécifié, afin de déclencher l’optimisation du journal.
Lors du déclenchement de l’optimisation du journal, un message d’avertissement est journalisé pour indiquer que les autres entrées de journal identiques seront supprimées. Une fois la durée écoulée, la journalisation normale se poursuit et un message d’information est journalisé pour indiquer que les doublons d’entrées du journal ne sont plus supprimés.
Journaux de Powershell et de la console de gestion
Les modifications de configuration effectuées via PowerShell ou la console de gestion sont enregistrées dans C:\Program Files\Citrix\Receiver StoreFront\Admin\logs. Le nom du fichier journal contient les actions de commande et les objets, ainsi que les informations de date qui peuvent être utilisés pour différencier les séquences de commande.
Enregistrement des diagnostics
StoreFront écrit les journaux de diagnostic dans c:\Program Files\Citrix\Receiver StoreFront\admin\trace
Pour les versions 2311 et supérieures de StoreFront, par défaut, les messages de niveau Erreur, Avertissementet Infos sont enregistrés. Dans la plupart des cas, ils incluent suffisamment d’informations pour diagnostiquer les éventuels problèmes.
Remarque :
Dans les versions 2308 et antérieures de StoreFront, seuls les messages de niveau Erreur sont enregistrés par défaut.
Vous pouvez activer une journalisation détaillée supplémentaire à des fins de dépannage. Cela n’est requis que si le support Citrix le demande. Cette journalisation peut avoir un impact sur les performances. Vous devez donc redéfinir TraceLevel sur Info une fois le dépannage terminé.
Pour activer la journalisation détaillée :
-
À l’aide d’un compte disposant d’autorisations d’administrateur local, démarrez Windows PowerShell
-
Entrez la commande :
Set-STFDiagnostics -All -TraceLevel "Verbose" -Override -confirm:$False <!--NeedCopy-->Remarque :
Le paramètre
-Overrideest obligatoire uniquement pour StoreFront 2311. Ce paramètre sera supprimé des versions ultérieures de StoreFront.Cela active une journalisation détaillée pour tous les services, sans demande de confirmation. Lorsque cette commande est entrée, les services StoreFront sont redémarrés. Attendez le retour de l’invite PowerShell pour vérifier que le redémarrage des services est terminé. Pendant le redémarrage de ces services, le serveur StoreFront ne sera pas accessible aux utilisateurs.
-
Reproduisez le problème pour créer les journaux.
-
Redéfinissez le niveau de journalisation par défaut pour tous les services
Set-STFDiagnostics -All -TraceLevel "Info" -Override -confirm:$False <!--NeedCopy-->Remarque :
Le paramètre
-Overrideest obligatoire uniquement pour la version 2311 de StoreFront.
Vous pouvez personnaliser davantage la journalisation de diagnostic :
-
StoreFront écrit un fichier journal distinct pour chaque service. Par défaut, la taille maximale de chaque fichier journal est de 200 Mo. StoreFront écrit jusqu’à cinq fichiers journaux par service avant de purger les anciens fichiers journaux. Si vous devez personnaliser la taille ou le nombre de journaux écrits, vous pouvez le faire à l’aide des paramètres
-FileSizeKbet-FileCount. -
Modifiez le niveau de détail enregistré à l’aide de
-TraceLevel. Les valeurs autorisées sontOff,Error,Warning,InfoouVerbose. -
L’utilisation du paramètre
-Alldéfinit les paramètres de journalisation pour tous les services. Vous pouvez personnaliser la journalisation pour un service individuel en utilisant-Service [Service name].
Pour plus d’informations sur l’applet de commande Set-STFDiagnostics, consultez la documentation StoreFront PowerShell SDK.
Journalisation du fichier launch.ica
Lorsqu’un utilisateur lance une application ou un bureau, StoreFront génère un fichier appelé launch.ica que l’application Workspace lit pour déterminer comment se connecter à l’application ou au bureau. Selon la configuration, ce fichier peut être stocké en mémoire et ne pas être directement accessible. Pour diagnostiquer les erreurs de lancement, il peut être utile de consulter le contenu de launch.ica.
Pour autoriser la journalisation du fichier launch.ica sur le PC client, procédez comme suit :
-
Accédez à la clé de registre suivante en utilisant l’éditeur de registre :
Systèmes 32 bits :
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\LoggingSystèmes 64 bits :
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging -
Définissez les deux valeurs de clé de chaîne suivantes :
- LogFile =”chemin vers le fichier journal”
- LogICAFile=true
Par exemple :
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
Remarque :
L’utilisation d’un fichier ICA dans votre environnement pour autre chose qu’un dépannage est abordée dans l’article CTX200126.