Problembehandlung für 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 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 doppelter 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 die Datei web.config für den Authentifizierungsdienst, den Store oder die Receiver für Web-Site mit einem Texteditor. 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 doppelter 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 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 Namen der Protokolldateien enthalten Befehlsaktionen und -subjekte sowie Zeitstempel, die zur Unterscheidung von Befehlssequenzen verwendet werden können.
Diagnoseprotokollierung
Zuvor protokollierte die Diagnoseprotokollierung standardmäßig nur Fehler.
Ab der Version 2203 LTSR CU5 werden standardmäßig Meldungen der Stufen Error, Warning und Info protokolliert. In den meisten Fällen enthält dies ausreichende Informationen zur Diagnose von Problemen.
Um die Ablaufverfolgung zu aktivieren, starten Sie Windows PowerShell mit einem Konto mit lokalen Administratorberechtigungen und verwenden Sie den Befehl Set-STFDiagnostics mit den folgenden Parametern:
- -All. Ein Flag, das angibt, dass die Ablaufverfolgung für alle Instanzen und Dienste aktualisiert werden soll.
- -TraceLevel. In aufsteigender Reihenfolge des Detaillierungsgrads der Ablaufverfolgung sind die zulässigen Werte für -TraceLevel: Off, Error, Warning, Info oder Verbose. Aufgrund der großen Datenmenge, die generiert werden kann, kann die Ablaufverfolgung die Leistung von StoreFront erheblich beeinträchtigen. Die Stufen Info oder Verbose werden nicht empfohlen, es sei denn, sie sind für die Fehlerbehebung ausdrücklich erforderlich.
Optionale Parameter:
- -FileSizeKb. Die Größe der Ablaufverfolgungsdatei in KB.
- -FileCount. Die Anzahl der Ablaufverfolgungsdateien, die gleichzeitig auf dem Datenträger vorgehalten werden sollen.
- -confirm:$False. Unterdrückt Windows-Eingabeaufforderungen, damit das StoreFront-Cmdlet jedes Mal ausgeführt werden kann.
Die Ablaufverfolgungsausgabe wird an c:\Program Files\Citrix\Receiver StoreFront\admin\trace gesendet.
Beispiele
So aktivieren Sie die Ablaufverfolgung auf der Ebene „Verbose“ für alle Dienste zu Debugging-Zwecken:
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False
<!--NeedCopy-->
So deaktivieren Sie die Ablaufverfolgung auf der Ebene „Verbose“ und setzen die Ablaufverfolgungsebene für alle Dienste auf den Standardwert zurück:
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False
<!--NeedCopy-->
Weitere Informationen zum Cmdlet Set-STFDiagnostics finden Sie in der Dokumentation zum StoreFront PowerShell SDK.
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.
Führen Sie die folgenden Schritte aus, um die Protokollierung der Datei launch.ica zu aktivieren:
-
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.