Dépanner 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 ultérieures 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 des 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
Auparavant, la journalisation des diagnostics n’enregistrait par défaut que les erreurs.
À partir de la version 2203 LTSR CU5, par défaut, les messages de niveau Erreur, Avertissement et Info sont enregistrés. Dans la plupart des cas, cela inclut des informations suffisantes pour diagnostiquer tout problème.
Pour activer la journalisation de trace, à l’aide d’un compte disposant des autorisations d’administrateur local, démarrez Windows PowerShell et utilisez la commande Set-STFDiagnostics avec les paramètres suivants :
- -All. Un indicateur spécifiant que le traçage doit être mis à jour pour toutes les instances et tous les services.
- -TraceLevel. Par niveaux croissants de détail de traçage, les valeurs autorisées pour -TraceLevel sont : Off, Error, Warning, Info ou Verbose. En raison de la grande quantité de données pouvant être générées, le traçage peut avoir un impact significatif sur les performances de StoreFront. Les niveaux Info ou Verbose ne sont pas recommandés, sauf si cela est spécifiquement requis pour le dépannage.
Paramètres facultatifs :
- -FileSizeKb. La taille du fichier de trace en Ko.
- -FileCount. Le nombre de fichiers de trace à conserver sur le disque à la fois.
- -confirm:$False. Supprime les invites Windows pour permettre l’exécution du cmdlet StoreFront à chaque fois.
La sortie de trace est envoyée à c:\Program Files\Citrix\Receiver StoreFront\admin\trace
Exemples
Pour activer le traçage de niveau détaillé (Verbose) pour tous les services à des fins de débogage :
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False
<!--NeedCopy-->
Pour désactiver le traçage de niveau détaillé (Verbose) et rétablir le niveau de traçage par défaut pour tous les services :
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False
<!--NeedCopy-->
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 donc ne pas être 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, 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.