Dépannage de StoreFront
Journaux d’installation
Lors de l’installation ou de la désinstallation de StoreFront, les fichiers journaux suivants sont créés par le programme d’installation de StoreFront dans le répertoire C:\Windows\Temp\StoreFront. Les noms de 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 des é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 écrits dans le journal d’applications StoreFront, qui peut être consulté à l’aide de l’Observateur d’événements sous Journaux des applications et des services > Citrix Delivery Services ou Journaux Windows > Application. Vous pouvez contrôler le nombre d’entrées de journal en double pour un seul événement en modifiant les fichiers de configuration du service d’authentification, des magasins et des sites Receiver pour Web.
Limitation des journaux
-
Utilisez un éditeur de texte pour ouvrir le fichier web.config pour le service d’authentification, le magasin ou le site Receiver pour Web, qui se trouvent généralement dans les répertoires C:\inetpub\wwwroot\Citrix\Authentication\, C:\inetpub\wwwroot\Citrix\storename\ et C:\inetpub\wwwroot\Citrix\storenameWeb\, respectivement, où storename est le nom spécifié pour le magasin lors 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 d’entrées de journal en double à 10 par minute.
-
Modifiez la valeur de l’attribut duplicateInterval pour définir la période (en heures, minutes et secondes) pendant laquelle les entrées de journal en double sont surveillées. Utilisez l’attribut duplicateLimit pour définir le nombre d’entrées en double qui doivent être enregistrées dans l’intervalle de temps spécifié pour déclencher la limitation des journaux.
Lorsque la limitation des journaux est déclenchée, un message d’avertissement est enregistré pour indiquer que les entrées de journal identiques supplémentaires seront supprimées. Une fois le délai écoulé, la journalisation normale reprend et un message d’information est enregistré, indiquant que les entrées de journal en double ne sont plus supprimées.
Journaux PowerShell et de la console de gestion
Les modifications de configuration effectuées via PowerShell ou la console de gestion sont enregistrées à l’emplacement C:\Program Files\Citrix\Receiver StoreFront\Admin\logs. Les noms de fichiers journaux contiennent les actions et les sujets des commandes, ainsi que des horodatages qui peuvent être utilisés pour différencier les séquences de commandes.
Journalisation des diagnostics
StoreFront écrit les journaux de diagnostic dans c:\Program Files\Citrix\Receiver StoreFront\admin\trace
Par défaut, les messages de niveau Erreur, Avertissement et Info sont enregistrés. Dans la plupart des cas, cela inclut suffisamment d’informations pour diagnostiquer tout problème.
Vous pouvez activer une journalisation détaillée supplémentaire à des fins de dépannage. Ceci n’est requis que si le support Citrix® le demande. Cela peut avoir un impact sur les performances, vous devez donc rétablir le TraceLevel sur Info une fois le dépannage terminé.
Pour activer la journalisation détaillée :
-
À l’aide d’un compte disposant des autorisations d’administrateur local, démarrez Windows PowerShell
-
Saisissez la commande :
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False <!--NeedCopy-->Ceci active la journalisation « Verbose » pour tous les services, sans demander de confirmation. Lorsque cette commande est saisie, elle redémarre les services StoreFront. Attendez que l’invite PowerShell réapparaisse pour vérifier que les services ont terminé de redémarrer. 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.
-
Rétablissez le niveau de journalisation par défaut pour tous les services
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False <!--NeedCopy-->
Vous pouvez personnaliser davantage la journalisation des diagnostics :
-
StoreFront écrit un fichier journal distinct pour chaque service. Par défaut, chaque fichier journal peut atteindre 200 Mo et 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 à l’aide de-Service [Service name].
Pour plus d’informations sur l’applet de commande Set-STFDiagnostics, consultez la documentation du SDK PowerShell de StoreFront.
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 n’est donc pas directement accessible. Pour diagnostiquer les erreurs de lancement, il peut être utile d’afficher le contenu de launch.ica.
Pour activer la journalisation du fichier launch.ica sur le PC client, suivez les étapes suivantes :
-
Accédez à la clé de registre suivante à l’aide de 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 d’accès au fichier journal”
- LogICAFile=true
Par exemple :
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
Remarque :
L’utilisation d’un fichier ICA dans votre environnement à d’autres fins que le dépannage est décrite plus en détail dans CTX200126.