StoreFront-Fehlerbehebung
Installationsprotokolle
Wenn StoreFront installiert oder deinstalliert wird, erstellt das StoreFront-Installationsprogramm die folgenden Protokolldateien im Verzeichnis C:\Windows\Temp\StoreFront. 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 interaktiv oder unbeaufsichtigt deinstalliert wird.
- CitrixMsi-CitrixStoreFront-x64-*.log – Wird erstellt, wenn StoreFront interaktiv oder unbeaufsichtigt installiert und deinstalliert wird.
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. Diese befinden sich typischerweise in den Verzeichnissen C:\inetpub\wwwroot\Citrix\Authentication\, C:\inetpub\wwwroot\Citrix\storename\ bzw. C:\inetpub\wwwroot\Citrix\storenameWeb\, wobei storename der Name ist, der beim Erstellen des Stores 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 AttributduplicateLimit, 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 anzeigt, 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 Protokolldateinamen enthalten Befehlsaktionen und -themen 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 für Fehlerbehebungszwecke aktivieren. Dies ist nur erforderlich, wenn dies vom Citrix® Support angefordert wird. Dies kann sich auf die Leistung auswirken, daher sollten Sie den TraceLevel auf Info zurücksetzen, sobald die Fehlerbehebung abgeschlossen ist.
So aktivieren Sie die ausführliche Protokollierung (Verbose):
-
Starten Sie Windows PowerShell mit einem Konto mit lokalen Administratorberechtigungen.
-
Geben Sie den Befehl ein:
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False <!--NeedCopy-->Dies aktiviert die “Verbose”-Protokollierung für alle Dienste, ohne zur Bestätigung aufzufordern. 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. -
Mit dem Parameter
-Allwerden die Protokollierungsparameter für alle Dienste festgelegt. Sie können die Protokollierung für einen einzelnen Dienst mit-Service [Dienstname]anpassen.
Weitere Informationen zum Cmdlet Set-STFDiagnostics 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 die Verbindung zur App oder zum Desktop herzustellen. 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 Registrierungseditor 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
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.