Logdatei für den combit CRM Workflow-Server (WFS) erstellen

Knowledgebase
1

Logdatei für den Workflow-Server erstellen

Dieser Artikel beschreibt, wie Sie bei Problemen mit der Verwendung des combit CRM Workflow-Server (nachfolgend kurz WFS) eine Logdatei für den combit-Support erstellen.

Es wird zwischen zwei Möglichkeiten unterschieden, wie der WFS ausgeführt werden kann:

  • A) Der WFS wird als Anwendung gestartet (angemeldet als Benutzer Workflow)
  • B) Der WFS wird als Windows-Dienst ausgeführt

A) WFS läuft als Anwendung

1. combit CRM vollständig beenden

  • Stellen Sie sicher, dass combit CRM nicht mehr geöffnet ist.
  • Prüfen Sie auch den Infobereich der Windows-Taskleiste (neben der Uhr), dort darf kein combit CRM-Symbol mehr angezeigt werden.

2. combit CRM mit Debug-Logging starten

  • Öffnen Sie das combit CRM-Installationsverzeichnis.
  • Starten Sie dort die Anwendung cRM_WithDebugLogging.exe.
  • combit CRM bzw. WFS wird nun mit aktivem Logging gestartet.
  • Gleichzeitig öffnet sich automatisch die Anwendung Debwin4.

3. Debwin4 für Support-Ausgaben konfigurieren

  • Wechseln Sie zu Debwin4.
  • Klicken Sie in der Symbolleiste auf das Nachrichten-Symbol (Symbol Papier mit grünem Plus-Zeichen).
  • Fügen Sie in der Liste eine neue Nachricht mit dem Namen combit-Support hinzu.
  • Bestätigen Sie die Eingabe.

4. Problem nachstellen

  • Starten Sie nun den WFS.
  • Wenn das Problem reproduzierbar ist, sorgen Sie dafür, dass das Problem jetzt ausgelöst wird
    (z. B. durch geplante Jobs, manuelles Anstoßen etc.).
  • Warten Sie, bis der Fehler auftritt bzw. die Situation erreicht ist, die untersucht werden soll.

5. Logdatei speichern und bereitstellen

  • Wechseln Sie wieder zu Debwin4.
  • Wählen Sie dort Save Log.
  • Speichern Sie die Logdatei (Dateiendung .log4) in ein beliebiges Verzeichnis.
  • Packen Sie diese nun in ein ZIP-Archiv (z. B. per Rechtsklick > Senden an > ZIP-komprimierter Ordner).
  • Laden Sie dieses ZIP-Archiv in Ihrem Support-Case hoch oder hängen Sie es an Ihre Support-Anfrage an.

B) WFS läuft als Windows-Dienst

Voraussetzungen

  • Der WFS ist als Dienst bereits installiert.
  • Es läuft keine weitere combit CRM-Instanz auf dem System.
  • Sie sind mit dem gleichen Windows-Benutzer angemeldet, unter dem auch der Dienst läuft.
  • Sie benötigen administrative Rechte.

Wichtiger Hinweis: Wenn der Dienst bereits läuft, bevor Debwin4 gestartet wird, erscheinen keine Logausgaben in Debwin4. Deshalb muss der Dienst zunächst gestoppt werden.

1. combit CRM Workflow-Server Dienst stoppen

  • Öffnen Sie die Windows-Diensteverwaltung (services.msc).
  • Suchen Sie den Dienst des WFS: combit CRM Workflow-Server.
  • Markieren Sie diesen, wählen Beenden und warten Sie, bis dieser wirklich gestoppt ist.

2. Debwin4 als Administrator starten

  • Starten Sie Debwin4 aus dem combit CRM-Verzeichnis heraus mit Rechtsklick > Als Administrator ausführen.
  • Wählen Sie Capture combit CRM Log aus.

3. WFS-Dienst starten

  • Wechseln Sie zurück in die Diensteverwaltung.
  • Starten Sie den WFS-Dienst erneut über Starten.
  • Nun sollten die Log-Ausgaben des Dienstes in Debwin4 erscheinen.

4. Problem nachstellen

  • Wenn das Problem reproduzierbar ist, sorgen Sie dafür, dass das Problem jetzt ausgelöst wird
    (z. B. durch geplante Jobs, manuelles Anstoßen etc.).
  • Warten Sie, bis der Fehler auftritt bzw. die Situation erreicht ist, die untersucht werden soll.

5. Logdatei speichern und bereitstellen

  • Wechseln Sie wieder zu Debwin4.
  • Wählen Sie dort Save Log.
  • Speichern Sie die Logdatei (Dateiendung .log4) in ein beliebiges Verzeichnis.
  • Packen Sie diese nun in ein ZIP-Archiv (z. B. per Rechtsklick > Senden an > ZIP-komprimierter Ordner).
  • Laden Sie dieses ZIP-Archiv in Ihrem Support-Case hoch oder hängen Sie es an Ihre Support-Anfrage an.

Alternative Logerstellung über Registry-Eintrag

Falls das Logging nicht mit Debwin4 möglich sein sollte, kann das Erstellen einer Logdatei auch über die Registry erzwungen werden. Dies gilt für beide o. g. WFS-Ausführungsmöglichkeiten A) und B).

1. WFS als Anwendung bzw. Dienst beenden

Führen Sie hier entsprechend den Punkt A.1 oder B.1 (siehe oben) aus.

2. Registry-Editor öffnen

  • Drücken Sie Windows-Taste + R.
  • Geben Sie dort den Befehl regedit ein und bestätigen diesen mit Enter.
  • Bestätigen Sie nun die UAC-Sicherheitsabfrage mit Ja.

3. Zum entsprechenden Schlüssel navigieren

Navigieren Sie im Registry-Editor zu folgendem Pfad: HKEY_LOCAL_MACHINE\SOFTWARE\combit

4. Eintrag „Debug.LogFilename“ anlegen oder bearbeiten

  • Prüfen Sie, ob der Eintrag Debug.LogFilename (REG_SZ) bereits vorhanden ist. Falls nicht, legen Sie ihn als neuen Zeichenfolgenwert an.
  • Tragen Sie anschließend den vollständigen Pfad zu der gewünschten Logdatei ein, z. B. C:\Temp\WFS_Debug.log4.

5. WFS als Anwendung bzw. Dienst starten und Problem nachstellen

  • Starten Sie nun den WFS als Anwendung bzw. den Workflow-Server-Dienst combit CRM Workflow-Server.
  • Wenn das Problem reproduzierbar ist, sorgen Sie dafür, dass das Problem jetzt ausgelöst wird
    (z. B. durch geplante Jobs, manuelles Anstoßen etc.).
  • Warten Sie, bis der Fehler auftritt bzw. die Situation erreicht ist, die untersucht werden soll.
  • Die Log-Ausgaben werden nun automatisch in die angegebene Datei geschrieben.

6. Logdatei bereitstellen

  • Packen Sie die Logdatei nun in ein ZIP-Archiv (z. B. per Rechtsklick > Senden an > ZIP-komprimierter Ordner).
  • Laden Sie dieses ZIP-Archiv in Ihrem Support-Case hoch oder hängen Sie es an Ihre Support-Anfrage an.

7. Eintrag „Debug.LogFilename“ wieder deaktivieren

WICHTIG: Nach dem erfolgreichen Erstellen der Logdatei und der Bereitstellung für den combit Support, ist es manuell erforderlich auch den Registry-Eintrag wieder umzubenennen bzw. zu entfernen, damit dieser nicht weiter aktiv ist und kein weiteres Logging durchgeführt wird, da dies Einfluss auf die allgemeine Performance und auch den Festplattenspeicher haben kann.