Problembehandlung bei StoreFront

Hinweis:

Informationen zu den Produktnamenänderungen finden Sie unter Neue Features.

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.

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.

Die Citrix StoreFront-Verwaltungskonsole zeichnet automatisch Ablaufverfolgungsinformationen auf. Standardmäßig ist die Ablaufverfolgung für andere Vorgänge deaktiviert und muss manuell aktiviert werden. Von Windows PowerShell-Befehlen erstellte Protokolle werden im Verzeichnis \Admin\logs\ der StoreFront-Installation gespeichert, normalerweise C:\Programme\Citrix\Receiver StoreFront. Die Protokolldateinamen enthalten Befehlsaktionen und Themen sowie einen Zeitstempel, anhand derer zwischen den Befehlssequenzen unterschieden werden kann.

Wichtig:

Verwenden Sie in einer Multiserverbereitstellung jeweils nur einen Server, um Änderungen an der Konfiguration der Servergruppe vorzunehmen. Stellen Sie sicher, dass die Citrix StoreFront-Verwaltungskonsole nicht auf den anderen Servern der Bereitstellung ausgeführt wird. Zum Abschluss übertragen Sie die Konfigurationsänderungen auf die Servergruppe, sodass die anderen Server der Bereitstellung aktualisiert werden.

Konfigurieren der 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.

Aktivieren der Ablaufverfolgung zur Problembehandlung

Wichtig:

Die StoreFront- und PowerShell-Konsolen können nicht gleichzeitig geöffnet sein. Schließen Sie immer zuerst die StoreFront-Verwaltungskonsole, bevor Sie die PowerShell-Konsole zum Verwalten der StoreFront-Konfiguration öffnen. Schließen Sie ebenso immer alle Instanzen der PowerShell-Konsole, bevor Sie die StoreFront-Konsole öffnen.

Die Ausgabe der Ablaufverfolgung wird an c:\Program Files\Citrix\Receiver StoreFront\admin\trace gesendet.

Ausgabe der Ablaufverfolgung

Hinweis:

Führen Sie Get-Help Set-STFDiagnostics -detailed aus, um die Powershell-Hilfe und Anweisungen für die Cmdlet Set-STFDiagnostics anzuzeigen.

Starten Sie mit einem Konto mit lokalen Administratorrechten Windows PowerShell und geben Sie an der Eingabeaufforderung die erforderlichen Parameter ein, um die Ablaufverfolgung zu aktivieren oder zu deaktivieren.

  • -All. Ein Flag, das angibt, dass die Ablaufverfolgung für alle Instanzen und Dienste aktualisiert werden soll.
  • -TraceLevel. In aufsteigender Detaildichte sind die zulässige Werte für “-TraceLevel”: Off, Error, Warning, Info, Verbose. Aufgrund der großen Datenmenge, die generiert werden kann, kann die Ablaufverfolgung die Leistung von StoreFront erheblich beeinträchtigen. “Info” oder “Verbose” werden nicht empfohlen, es sei denn, sie sind speziell für die Problembehandlung erforderlich.

Optionale Parameter:

  • -FileSizeKb. Die Größe der Ablaufverfolgungsdatei in KB.
  • -FileCount. Die Anzahl der Ablaufverfolgungsdateien, die gleichzeitig auf dem Datenträger verwaltet werden sollen.
  • -confirm:$False. Unterdrückt Windows-Aufforderungen, damit das Cmdlet StoreFront jedes Mal ausgeführt werden kann.

Beispiele

Aktivieren der Ablaufverfolgung mit der Stufe “Verbose” für alle Dienste für das Debugging:

Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False

Deaktivieren der Ablaufverfolgung mit der Stufe “Verbose” und Zurücksetzen der Ablaufverfolgung auf den Standardwert für alle Dienste:

Set-STFDiagnostics -All -TraceLevel "Error" -confirm:$False

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

Aktivieren der Protokollierung für die Datei launch.ica

Speichern Sie die Informationen in der Datei launch.ica auf dem Clientcomputer, um verschiedene Probleme zu behandeln. Die Datei launch.ica wird von Citrix Webinterface- oder Citrix StoreFront-Servern generiert.

Führen Sie die folgenden Schritte aus, um die Protokollierung der Datei launch.ica 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 den folgenden Zeichenfolgenwert fest:

    LogFile=<Pfad zur Protokolldatei, im Format C:\ica\ica.log> LogICAFile=true

Weitere Ressourcen

Hinweis:

Die Verwendung einer ICA-Datei in Ihrer Umgebung für andere Zwecke als die Problembehandlung wird in CTX200126näher erläutert.