Problembehandlung bei StoreFront
Installationsprotokolle
Wenn StoreFront installiert oder deinstalliert wird, werden die folgenden Protokolldateien vom StoreFront-Installationsprogramm im Verzeichnis C:\Windows\Temp\StoreFront erstellt. Die Dateinamen spiegeln die Komponenten wider, die sie erstellt haben, und enthalten Zeitstempel.
- Citrix-DeliveryServicesRoleManager-*.log—Wird erstellt, wenn StoreFront interaktiv installiert wird.
- Citrix-DeliveryServicesSetupConsole-*.log—Wird erstellt, wenn StoreFront unbeaufsichtigt installiert wird und wenn StoreFront deinstalliert wird, entweder interaktiv oder unbeaufsichtigt.
- CitrixMsi-CitrixStoreFront-x64-*.log—Wird erstellt, wenn StoreFront installiert und deinstalliert wird, entweder interaktiv oder unbeaufsichtigt.
Ereignisprotokolle
StoreFront unterstützt die Windows-Ereignisprotokollierung für den Authentifizierungsdienst, Stores und Receiver für Web-Sites. Alle generierten Ereignisse werden in das StoreFront-Anwendungsprotokoll geschrieben, das mit der Ereignisanzeige unter Anwendungs- und Dienstprotokolle > Citrix Delivery Services oder Windows-Protokolle > Anwendung angezeigt werden kann. Sie können die Anzahl der doppelten Protokolleinträge für ein einzelnes Ereignis steuern, indem Sie die Konfigurationsdateien für den Authentifizierungsdienst, Stores und Receiver für Web-Sites bearbeiten.
Protokolldrosselung
-
Öffnen Sie mit einem Texteditor die Datei web.config für den Authentifizierungsdienst, den Store oder die Receiver für Web-Site, die sich typischerweise in den Verzeichnissen C:\inetpub\wwwroot\Citrix\Authentication\, C:\inetpub\wwwroot\Citrix\storename\ und C:\inetpub\wwwroot\Citrix\storenameWeb\ befinden, wobei storename der Name ist, der für den Store bei seiner Erstellung angegeben wurde.
-
Suchen Sie das folgende Element in der Datei.
<logger duplicateInterval="00:01:00" duplicateLimit="10">Standardmäßig ist StoreFront so konfiguriert, dass die Anzahl der doppelten Protokolleinträge auf 10 pro Minute begrenzt ist.
-
Ändern Sie den Wert des Attributs duplicateInterval, um den Zeitraum in Stunden, Minuten und Sekunden festzulegen, über den doppelte Protokolleinträge überwacht werden. Verwenden Sie das Attribut duplicateLimit, um die Anzahl der doppelten Einträge festzulegen, die innerhalb des angegebenen Zeitintervalls protokolliert werden müssen, um die Protokolldrosselung auszulösen.
Wenn die Protokolldrosselung ausgelöst wird, wird eine Warnmeldung protokolliert, die darauf hinweist, dass weitere identische Protokolleinträge unterdrückt werden. Sobald das Zeitlimit abgelaufen ist, wird die normale Protokollierung fortgesetzt und eine Informationsmeldung protokolliert, die darauf hinweist, dass doppelte Protokolleinträge nicht mehr unterdrückt werden.
PowerShell- und Verwaltungskonsolenprotokolle
Konfigurationsänderungen, die über PowerShell oder die Verwaltungskonsole vorgenommen werden, werden unter C:\Program Files\Citrix\Receiver StoreFront\Admin\logs protokolliert. Die Namen der Protokolldateien enthalten Befehlsaktionen und -subjekte sowie Zeitstempel, die zur Unterscheidung von Befehlssequenzen verwendet werden können.
Diagnoseprotokollierung
StoreFront schreibt Diagnoseprotokolle nach c:\Program Files\Citrix\Receiver StoreFront\admin\trace
Standardmäßig werden Meldungen der Stufen Error, Warning und Info protokolliert. In den meisten Fällen enthält dies ausreichende Informationen zur Diagnose von Problemen.
Sie können zusätzliche ausführliche Protokollierung zu Fehlerbehebungszwecken aktivieren. Dies ist nur auf Anfrage des Citrix® Supports erforderlich. Dies kann sich auf die Leistung auswirken, daher sollten Sie die TraceLevel nach Abschluss der Fehlerbehebung auf Info zurücksetzen.
So aktivieren Sie die ausführliche Protokollierung:
-
Starten Sie Windows PowerShell mit einem Konto mit lokalen Administratorberechtigungen.
-
Befehl eingeben:
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False <!--NeedCopy-->Dies aktiviert die „ausführliche“ Protokollierung für alle Dienste, ohne eine Bestätigung anzufordern. Wenn dieser Befehl eingegeben wird, werden die StoreFront-Dienste neu gestartet. Warten Sie, bis die PowerShell-Eingabeaufforderung zurückkehrt, um zu überprüfen, ob die Dienste neu gestartet wurden. Während diese Dienste neu gestartet werden, ist der StoreFront-Server für Benutzer nicht zugänglich.
-
Reproduzieren Sie das Problem, um die Protokolle zu erstellen.
-
Setzen Sie die Protokollierung für alle Dienste auf die Standardstufe zurück.
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False <!--NeedCopy-->
Sie können die Diagnoseprotokollierung weiter anpassen:
-
StoreFront schreibt für jeden Dienst eine separate Protokolldatei. Standardmäßig ist jede Protokolldatei bis zu 200 MB groß, und StoreFront schreibt bis zu fünf Protokolldateien pro Dienst, bevor alte Protokolldateien gelöscht werden. Wenn Sie die Größe oder Anzahl der geschriebenen Protokolle anpassen müssen, können Sie dies mit den Parametern
-FileSizeKbund-FileCounttun. -
Ändern Sie den Detaillierungsgrad der Protokollierung mit
-TraceLevel. Zulässige Werte sindOff,Error,Warning,InfooderVerbose. -
Die Verwendung des Parameters
-Alllegt die Protokollierungsparameter für alle Dienste fest. Sie können die Protokollierung für einen einzelnen Dienst mit-Service [Service name]anpassen.
Weitere Informationen zum Set-STFDiagnostics-Cmdlet finden Sie in der StoreFront PowerShell SDK-Dokumentation.
Protokollierung der Datei Launch.ica
Wenn ein Benutzer eine App oder einen Desktop startet, generiert StoreFront eine Datei namens launch.ica, die von der Workspace-App gelesen wird, um zu bestimmen, wie eine Verbindung zur App oder zum Desktop hergestellt werden soll. Je nach Konfiguration kann diese Datei im Speicher abgelegt werden und ist daher nicht direkt zugänglich. Zur Diagnose von Startfehlern kann es nützlich sein, den Inhalt von launch.ica anzuzeigen.
Um die Protokollierung der Datei launch.ica auf dem Client-PC zu aktivieren, führen Sie die folgenden Schritte aus:
-
Navigieren Sie mit dem Registrierungs-Editor zum folgenden Registrierungsschlüssel:
32-Bit-Systeme:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging64-Bit-Systeme:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging -
Legen Sie die folgenden zwei Zeichenfolgen-Schlüsselwerte fest:
- LogFile=”Pfad zur Protokolldatei”
- LogICAFile=true
Zum Beispiel:
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
Hinweis:
Die Verwendung einer ICA-Datei in Ihrer Umgebung für andere Zwecke als die Fehlerbehebung wird in CTX200126 näher erläutert.