StoreFront

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 lassen die Komponenten erkennen, die sie erstellt haben, und enthalten einen Zeitstempel.

  • Citrix-DeliveryServicesRoleManager-*.log: wird bei der interaktiven Installation von StoreFront erstellt.
  • Citrix-DeliveryServicesSetupConsole-*.log: wird bei der Installation von StoreFront ohne Benutzereingriffe und bei Deinstallation mit oder ohne Benutzereingriffe erstellt.
  • CitrixMsi-CitrixStoreFront-x64-*.log: wird bei der Installation und Deinstallation von StoreFront mit oder ohne Benutzereingriffe erstellt.

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 über die 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, die Stores und Receiver für Web-Sites bearbeiten.

Protokolldrosselung

  1. Öffnen Sie die Datei web.config für den Authentifizierungsdienst, Store oder die Receiver für Web-Site mit einem Texteditor. Die Dateien sind normalerweise im Verzeichnis C:\inetpub\wwwroot\Citrix\Authentication, C:\inetpub\wwwroot\Citrix\storename und C:\inetpub\wwwroot\Citrix\storenameWeb\, wobei “storename” für den Namen steht, der beim Erstellen des Stores angegeben wurde.

  2. Suchen Sie das folgende Element in der Datei.

    <logger duplicateInterval="00:01:00" duplicateLimit="10">

    Standardmäßig wird in der Konfiguration von StoreFront die Anzahl der doppelten Protokolleinträge auf 10 pro Minute beschränkt.

  3. Ändern Sie den Wert des Attributs duplicateInterval, um den Zeitraum, in dem doppelte Protokolleinträge überwacht werden, in Stunden, Minuten und Sekunden festzulegen. Legen Sie mit dem Attribut duplicateLimit fest, wie viele doppelte Einträge im angegebenen Zeitraum protokolliert werden müssen, um die Protokolldrosselung auszulösen.

Wenn die Protokolldrosselung ausgelöst wird, wird eine Warnmeldung aufgezeichnet, um anzugeben, dass weitere identische Protokolleinträge unterdrückt werden. Nach Ablauf des Zeitraums wird die normale Protokollierung fortgesetzt und es wird eine Informationsmeldung aufgezeichnet, die angibt, dass doppelte Protokolleinträge nicht mehr unterdrückt werden.

PowerShell- und Verwaltungskonsolenprotokolle

Konfigurationsänderungen, die über PowerShell oder die Verwaltungskonsole vorgenommen wurden, werden in C:\Program Files\Citrix\Receiver StoreFront\Admin\logs protokolliert. Die Protokolldateinamen enthalten Befehlsaktionen und Themen sowie einen Zeitstempel, anhand derer zwischen den Befehlssequenzen unterschieden werden kann.

Protokollierung von Diagnosen

StoreFront speichert Diagnoseprotokolle in c:\Program Files\Citrix\Receiver StoreFront\admin\trace

Für StoreFront 2311-Versionen und höher werden standardmäßig Meldungen der Stufen Fehler, Warnung und Information protokolliert. In den meisten Fällen umfasst dies ausreichende Informationen, um Probleme zu diagnostizieren.

Hinweis:

In 2308 und früheren Versionen von StoreFront werden standardmäßig nur Meldungen der Stufe Fehler protokolliert.

Sie können zusätzliche ausführliche Protokollierung zur Problembehandlung aktivieren. Dies ist nur erforderlich, wenn dies vom Citrix Support angefordert wird. Dies kann sich auf die Leistung auswirken, daher sollten Sie die Einstellung TraceLevel nach Abschluss der Fehlerbehebung wieder auf Info setzen.

Aktivieren der ausführlichen Protokollierung:

  1. Verwenden Sie ein Konto mit lokalen Administratorberechtigungen, um Windows PowerShell zu starten

  2. Geben Sie diesen Befehl ein:

    Set-STFDiagnostics -All -TraceLevel "Verbose" -Override -confirm:$False
    <!--NeedCopy-->
    

    Hinweis:

    Der Parameter -Override ist nur für die StoreFront 2311-Version erforderlich. Dieser Parameter wird aus zukünftigen Versionen von StoreFront entfernt.

    Dadurch wird die “ausführliche” Protokollierung für alle Dienste aktiviert, ohne dass eine Bestätigung erforderlich ist. Wenn dieser Befehl eingegeben wird, werden die StoreFront-Dienste neu gestartet. Warten Sie, bis die PowerShell-Eingabeaufforderung erneut angezeigt wird, um zu überprüfen, ob der Neustart der Dienste abgeschlossen ist. Während diese Dienste neu gestartet werden, können Benutzer nicht auf den StoreFront-Server zugreifen.

  3. Reproduzieren Sie das Problem, um die Protokolle zu erstellen.

  4. Setzen Sie die Protokollierung für alle Dienste auf die Standardstufe zurück

     Set-STFDiagnostics -All -TraceLevel "Info" -Override -confirm:$False
    <!--NeedCopy-->
    

    Hinweis:

    Der Parameter -Override ist nur für die StoreFront 2311-Version erforderlich.

Sie können die Diagnoseprotokollierung weiter anpassen:

  • StoreFront erstellt für jeden Dienst eine separate Protokolldatei. Jede Protokolldatei kann standardmäßig bis 200 MB groß werden und StoreFront erstellt maximal fünf Protokolldateien pro Dienst, bevor alte Protokolldateien gelöscht werden. Wenn Sie die Größe oder Anzahl der Protokolle anpassen müssen, können Sie dies mit den Parametern -FileSizeKb und -FileCount tun.

  • Ändern Sie den Detaillierungsgrad, der mit -TraceLevel protokolliert wurde. Zulässige Werte sind Off, Error, Warning, Info oder Verbose.

  • Mit dem Parameter -All werden die Protokollierungsparameter für alle Dienste festgelegt. Mit -Service [Service name] können Sie die Protokollierung für einen einzelnen Dienst anpassen.

Weitere Informationen zum Cmdlet Set-STFDiagnostics finden Sie in der Dokumentation zum StoreFront PowerShell SDK.

Protokollierung der Launch.ica-Datei

Wenn ein Benutzer eine App oder einen Desktop startet, generiert StoreFront eine Datei namens “launch.ica”, anhand derer die Workspace-App ermittelt, wie eine Verbindung mit der App oder dem Desktop hergestellt werden soll. Je nach Konfiguration wird diese Datei evtl. im Arbeitsspeicher abgelegt und ist nicht direkt zugänglich. Um Startfehler zu diagnostizieren, kann es nützlich sein, sich den Inhalt von launch.ica anzusehen.

Führen Sie folgende Schritte aus, um die Protokollierung der Datei launch.ica auf dem Client-PC zu aktivieren:

  1. Navigieren Sie mit dem Registrierungs-Editor zum folgenden Registrierungsschlüssel:

    32-Bit-Systeme: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging

    64-Bit-Systeme: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging

  2. Legen Sie die folgenden Zeichenfolgenwert 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 Problembehandlung wird in CTX200126näher erläutert.

Problembehandlung bei StoreFront