Product Documentation

Résolution des problèmes de StoreFront

Oct 31, 2016

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

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.

La console de gestion Citrix StoreFront enregistre automatiquement les informations de suivi. Par défaut, le suivi d'autres opérations est désactivé et doit être activé manuellement. Les journaux créés par les commandes Windows PowerShell sont stockés dans le répertoire \Admin\logs\ de l'installation StoreFront, généralement situé sur C:\Program Files\Citrix\Receiver StoreFront\. 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.

Important : dans les déploiements faisant appel à de multiples serveurs, n'utilisez qu'un serveur à la fois pour apporter des modifications à la configuration du groupe de serveurs. Assurez-vous que la console de gestion Citrix StoreFront n'est exécutée sur aucun des serveurs dans le déploiement. Une fois terminé, propagez les modifications que vous avez apportées à la configuration du groupe de serveurs de façon à mettre à jour les autres serveurs dans le déploiement.

Pour configurer l'optimisation du journal

  1. 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.
  2. 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.

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

Pour activer le suivi

Avertissement : les consoles StoreFront et PowerShell ne peuvent pas être ouvertes en même temps. Fermez toujours la console d'administration StoreFront avant d'utiliser la console PowerShell pour administrer votre configuration StoreFront. De même, fermez toutes les instances de PowerShell avant d'ouvrir la console StoreFront.
  1. Utilisez un compte possédant des permissions d'administrateur local pour démarrer Windows PowerShell et, à l'invite de commande, tapez les commandes suivantes et redémarrez le serveur pour activer le traçage.
    Add-PSSnapin Citrix.DeliveryServices.Framework.Commands  Set-DSTraceLevel -All -TraceLevel Verbose

    Les valeurs autorisées pour -TraceLevel sont, par ordre croissant de niveau de détail de suivi : Off, Error, Warning, Info, Verbose.
    StoreFront capture automatiquement les messages de trace d'erreur. Compte tenu du volume important de données qui peut être potentiellement généré, le suivi peut affecter de manière considérable les performances de StoreFront, il est donc recommandé de ne pas utiliser les niveaux Info ou Verbose à moins que cela ne soit nécessaire à des fins de dépannage.

    Les arguments facultatifs de l'applet de commande Set-DSTraceLevel sont :
    -FileCount: spécifie le nombre de fichiers de trace (valeur par défaut = 3)
    -FileSizeKb : spécifie la taille maximale de chaque fichier de trace (valeur par défaut = 1000
    -ConfigFile <NomFichier> : alternative à -All qui permet de mettre à jour un fichier de configuration spécifique plutôt que tous les fichiers.  Par exemple, une valeur -ConfigFile de c:\inetpub\wwwroot\Citrix\<NomMagasin>\web.config définirait le traçage pour le magasin appelé <NomMagasin>.

  2. Pour désactiver le suivi, tapez les commandes suivantes et redémarrez le serveur.
    Add-PSSnapin Citrix.DeliveryServices.Framework.Commands  Set-DSTraceLevel -All -TraceLevel Off

Lorsque le suivi est activé, les informations de suivi sont journalisées dans le répertoire d'installation de StoreFront (\Admin\Trace\) qui se trouve sur l'emplacement C:\Program Files\Citrix\Receiver StoreFront\.