Vorgehen zur Problemanalyse

An dieser Stelle möchten wir Ihnen einige einfache und wichtige Hinweise zur Vorgehensweise bei der Analyse von Problemen im Umfeld von CLARC ENTERPRISE an die Hand geben.

Die hier beschriebenen Themen erfordern eine gute Kenntnis des Systems, dessen Komponenten und deren Zusammenspiel. Letzteres ist der wohl relevanteste Punkt um einem Problem schnell auf die Schliche zu kommen. Eine Zusammenfassung der Verarbeitungsprozesse finden Sie im Bereich Referenz unter Prozessschemas.

Am Ende dieses Artikels finden Sie einen FAQ Bereich mit Lösungshinweisen zu häufigen Fragestellungen.

Problem eingrenzen

Der erste Schritt zur Klärung eines Problems ist die Eingrenzung auf das betroffene Modul. 

Hier eine mögliche Vorgehensweise mit Fragestellungen zur Annäherung:

• Tritt das Problem am Client oder am Server auf?
• Tritt das Problem direkt bei der Erfassung auf oder erst später bei der Verarbeitung?
• Mit welchem Modul soll das Dokument verarbeitet werden bzw. handelt es sich um einen Extraktions- oder Export-Schritt?

Problem bestimmen

Im zweiten Schritt sollte das genaue Problem bestimmt werden.

Zu jedem Prozess, Service oder Client gibt es Logfiles bzw. Möglichkeiten ein Logfile zu generieren.

Logfiles stellen also die erste Anlaufstelle für die Bestimmung des genauen Fehlers dar.

Schauen Sie in das Logfile des betreffenden Moduls und prüfen Sie den Bereich zur Uhrzeit an dem das problem aufgetreten ist. Suchen Sie dabei im Editor nach "error" oder "critical" bzw. einem Teil der Meldung die Sie ggf. erhalten haben. In den entsprechenden Logansichten im C4 verwenden Sie die entsprechend verfügbaren Suchfunktionen.

Sollten die Informationen im Log nicht ausreichen, prüfen Sie bitte ob der Log-Level der jeweiligen Anwendung mindestens auf Debug eingestellt wurde (siehe auch Logdateien). Bei einer Änderung muss der Fehler reproduziert und das Log erneut geprüft werden.

Bei Problemen am Client kann ein Development Log aktiviert werden. Siehe Entwicklungs-Modus.

Sofern sich das Problem explizit auf ein Dokument bezieht, kann auch das Dokumenten.Log im C4 herangezogen werden und der Verlauf des Dokuments mit evtl. Fehlermeldungen geprüft werden.

Fehlerquellen

Mögliche allgemeine Fehlerquellen können sein:

• Unzureichende Berechtigungen des Service-Benutzers.
  • Zugriff auf das Dateisystem.
  • Zugriff auf die Registry.
    • Schreibender Zugriff auf HKEY_LOCAL_MACHINE Bereiche.
      
      
• Aggressiv eingestellte Virenscanner.
  • Zugriffsblockierung auf Dateien und Netzwerkressourcen.
    • Hier ggf. Ausnahmen definieren.
      
      
• Strenge Firewall Regeln.
  • Kommunikationsproblem zwischen Client und Server.
  • Kommunikationsproblem unterhalb der Serverkomponenten.

FAQ

C4 Login scheitert

 Die Anmeldung am c4 funktioniert nicht.

Prüfen Sie ob der CLARC ENTERPRISE und zugehörige ASE Daemon gestartet ist. Der ASE Daemon kann auch als Anwendung ohne den ENTERPRISE Dienst gestartet werden (<clarc>\sys\ccasesrv.exe).

Das Standard Login ist clarc und admin.

Führen Sie im Notfall das „C4 Repair Setup“ aus. Siehe Server-Installation.

Dienst startet nicht

 Der Dienst startet nicht und bricht mit einer Fehlermeldung ab.

Prüfen Sie das Windows-Eventlog und die Logfiles (ccenterprisesrv und cclicsrv) unterhalb von <clarc>\log\. Siehe Logdateien.

Deaktivieren Sie zur Analyse die DEP, UAC und lokale Firewalls.

Keine Logs

 Es wird kein Logfile geschrieben.

Prüfen Sie den Registryeintrag unter HKLM\Software\clarc\System > Path

Stimmt dieser mit der Installation überein?

Port nicht frei

 Im Logfile steht das der Port von einer anderen Anwendung bereits in Verwendung ist.

Ändern Sie die Port-Einstellung in den Services für „ccenterprisesrv“ oder "cclicsrv" und versuchen Sie es erneut.

Bei allen Enterprise Services den entsprechenden Service-Eintrag im C4 ändern. Siehe Enterprise Services Konfiguration.

Lizenz abgelehnt

 Im Logfile steht das meine Lizenzanfrage abgelehnt wurde (license declined).

Kontrollieren Sie die Lizenzservereinstellungen in der Registry unter HKLM\Software\clarc\License und prüfen Sie die eingespielte Lizenz. Prüfen Sie dazu das Eventlog, das Lizenzserver-Logfile und ggf. die Web-Admin Konsole im Bereich Licensing.

Zudem überprüfen Sie die installierte Version des Lizenzservers und vergewissern Sie sich das die aktuellste Version installiert ist - passend zum Release.

ConfigManager Startfehler

 Im Logfile steht das der ConfigManager nicht starten konnte.

Prüfen Sie die Datenbankverbindungsdateien im Verzeichnis <clarc>\cfg\ (insbesondere die Datei ccsyscfg.udl). Stimmt die Verbindung, kann es sein das die Tabellen in der angegebenen Datenbank nicht vorhanden sind oder keine Berechtigungen vorliegen.

Evtl. liegt auch ein Zeitpunktproblem vor. Es kann vorkommen das der Datenbankserver zwar gestartet, jedoch noch keine Verbindungen annimmt. Prüfen Sie hier die Datenbankverbindungsparameter in der Registry (Timeouts). Siehe Datenbankverbindung.

Instanz startet nicht

 Eine neu definierte enterprise Service Instanz startet nicht.

Überprüfen Sie den C4 Eintrag für den ServicePath und das Logfile des entsprechenden Services. Evtl. ist der RootPort bereits belegt.

Netzwerkprobleme

 Verbindungsabbrüche, Übertragungsfehler und Datenbankverbindungsprobleme.

Überprüfen Sie die Logs der entsprechenden Server-Komponenten. Bei Netzwerkproblemen werden hier regelmäßig Fehler protokolliert, auch wenn im System aktuell keine Daten verarbeitet werden. Die Meldungen in diesem Bereich sind:

• "connection reset by peer"
• "connection closed gracefully"
• "database connection ... successfully restored"

Sollten diese und ähnliche Meldungen regelmäßig auftreten, sollte die entsprechenden Netzwerkadministration zu Rate gezogen werden.