Protokolldateien für DOORS und DWA

Mithilfe von Protokolldateien können Sie Fehler beheben, die auf dem Datenbankserver, Client und Interoperation Server von IBM® Engineering Requirements Management DOORS (DOORS) und im Server und Nachrichtenbroker von IBM Engineering Requirements Management DOORS - Web Access (DWA) auftreten.
Abhängig von der Konfiguration stehen die folgenden Protokollierungstools zum Diagnostizieren eines nicht erwarteten Verhaltens zur Verfügung:
  • Diagnoseprotokoll für den Client
  • Transaktionsprotokoll für den Datenbankserver
  • Transaktionsprotokoll für den Client
  • Protokolle für den DWA-Server, den Interoperation Server und den Nachrichtenbroker
  • Protokolle von Anwendungsnachrichten und das Dienstprogramm zur Datenerfassung

Diagnoseprotokoll für den DOORS-Client

Der Client verfügt über einen integrierten Protokollierungsmechanismus, von dem nicht erwartete Ereignisse aufgezeichnet werden, die als Ergebnis eines internen Fehlers während einer Sitzung auftreten. Klicken Sie zum Anzeigen des Diagnoseprotokolls auf Hilfe > Protokoll der Diagnoseprogramme anzeigen. Bei Bedarf können Sie die Informationen aus dem Ausgabefenster kopieren und in einer lokalen Textdatei speichern.

Zum Aufzeichnen eines detaillierteren Protokolls können Sie auf dem Client und dem Datenbankserver eine zusätzliche transaktionsorientierte Protokollierung aktivieren. Weitere Informationen hierzu finden Sie in den folgenden Abschnitten.

Datenbankserverprotokollierung für DOORS

Auf dem Datenbankserver wird eine Protokollierung bereitgestellt, mit der Aktivitäten auf unterschiedlichen Detaillierungsebenen aufgezeichnet werden können. Diese Protokollierung ist standardmäßig nicht aktiviert, weil sie die Prozessorauslastung für Transaktionen erhöhen und damit die Geschwindigkeit für die Ausführung einer erforderlichen Funktion reduzieren oder die Gesamtleistung vermindern kann. Welche Details im Ausgabeprotokoll erfasst werden, hängt von der Protokollebene ab, die Sie festlegen. Die Werte reichen von Ebene 1 für die knappste Protokollierung bis zu Ebene 6 für die ausführlichste Protokollierung. Überprüfen Sie vor der Aktivierung einer Serverprotokollierung gemeinsam mit dem Support, welche Ebene zur Lösung des Problems erforderlich ist.

Tabelle 1. Protokollebenen
Protokollebene Details der Protokollinformationen
1 Verbindungen, Verbindungstrennungen und fehlerhafte Pakete
2 Verbindungen, Verbindungstrennungen und Pakettypen
3 Verbindungen, Verbindungstrennungen, Pakettypen und Paketargumente im kompakten Format
4 Verbindungen, Verbindungstrennungen, Pakettypen und Paketargumente im ausführlichen Format
5 Nur Operationen des Datencache
6 Verbindungen, Verbindungstrennungen, Operationen des Datencache, Pakettypen und Paketargumente im ausführlichen Format
Zum Ermitteln eines unspezifizierten Fehlers kann es erforderlich sein, die Protokollierung auf Ebene 6 zu starten, um alle Aktivitäten zu erfassen. Senden Sie die generierte Protokolldatei nach der Aktivierung der Datenbankprotokollierung und der Reproduzierung des Verhaltens an den Support und inaktivieren Sie die Protokollierung wie im Hilfeabschnitt Transaktionsprotokoll im DOORS-Datenbankserver aktivieren beschrieben.
Anmerkung: Aktivieren Sie die Datenbankprotokollierung nur für begrenzte Diagnosezeiträume, um Leistungseinbußen zu verhindern.

Clientprotokollierung für DOORS

Sie können eine Protokollierung aktivieren, um Verbindungsfehler zum Datenbankserver zu beheben. Im Protokoll sind keine Modul- oder Objektdaten enthalten, die inhaltsbezogene Informationen sein können; es enthält nur Details zur Dateiübertragung. Öffnen Sie auf dem Computer mit dem Fehler den DOORS-Client und führen Sie einen DXL-Befehl aus, um die Clientprotokollierung zu aktivieren und eine lokale Protokolldatei zu generieren. Senden Sie die generierte Protokolldatei nach der Reproduzierung des Verhaltens an den Support und inaktivieren Sie die Protokollierung wie im Hilfeabschnitt zur Clientprotokollierung Transaktionsprotokoll im DOORS-Client aktivieren beschrieben.

Protokollierung für den DOORS Interoperation Server und den DWA-Server und -Nachrichtenbroker

Von den DWA-Komponenten werden standardmäßig Protokolleinträge auf Informationsebene bereitgestellt. Auf der Informationsebene enthalten die Protokolleinträge Informationsnachrichten, in denen der Status der Anwendung auf einer allgemeinen Ebene beschrieben wird. Um weitere Details einzubeziehen, müssen Sie die Komponenten so aktivieren, dass sie auf der Debugstufe ausgeführt werden.

Von DOORS Interoperation Server und DWA-Server und -Nachrichtenbroker werden in den folgenden Verzeichnissen Protokolleinträge auf Informationsebene bereitgestellt:
  • DWA-INSTALLATIONSVERZEICHNIS\broker\data\activemq.log
  • DWA-INSTALLATIONSVERZEICHNIS\server\festival\logs
Informationen zur Generierung ausführlicher Informationen mit Protokollierung auf Debugstufe finden Sie unter den zugehörigen Links zur DWA-Protokollierung. Im Verzeichnis 'logs' befinden sich mehrere Protokolldateien. Beginnen Sie bei der Diagnose eines Problems mit den folgenden Dateien:
  • festival.log enthält jede Protokollnachricht, die vom DWA-Server geschrieben wurde.
  • request.log wird zum Überprüfen des Empfangs von Anforderungen verwendet. Dieses Protokoll ist bei Diagnoseprozessen hilfreich, die sich auf mehrere Anwendungen erstrecken.
  • response.log wird zum Bestätigen der Rückgabe von Antworten an die aufrufende Anwendung verwendet. Dieses Protokoll ist hilfreich, wenn bestätigt werden soll, dass die empfangene Anforderung ausgeführt und ein Ergebnis zurückgegeben wurde.
Fehlernachrichten werden abhängig von ihrem Ursprung in unterschiedliche Protokolldateien geschrieben. Die meisten Fehler werden in exception.log geschrieben, es können jedoch auch die anderen Fehlerprotokolldateien verwendet werden. Es gibt die folgenden drei Protokolldateien:
  • exception.log
  • error_view.log
  • error_misc.log

Protokollierung von Anwendungsnachrichten und das Dienstprogramm zur Datenerfassung

Mit Version 9.4 wurde die Protokollierung von Anwendungsnachrichten eingeführt, die auf Apache-log4cxx-Protokollservices basiert. Sie können diese Tasks ohne Neustart des Servers durchführen:
  • Protokolldateigröße begrenzen
  • Automatische Bereinigung für ältere Dateien einrichten
  • Format von Ausgabeprotokolldateien auswählen
  • Protokollebene und Protokollkonfigurationen ändern
Die Konfigurationsdatei wird in Abständen von 60 Sekunden zur Erfassung von Änderungen überwacht.

Es gibt fünf Protokollebenen (aufgelistet in aufsteigender Reihenfolge ihrer Priorität): 'Debug', 'Info', 'Warn', 'Error' und 'Fatal'. Auf jeder Protokollebene werden die Informationen für diese Ebene und alle höheren Ebenen protokolliert. Bei Verwendung der Ebene 'Warn' sind zum Beispiel die Informationen der Modi 'Warn', 'Error' und 'Fatal' eingeschlossen.

In älteren Versionen von DOORS waren zu Beginn der Fehlerbehebungsphase eine manuelle iterative Zusammenstellung von Umgebungs- und Ressourcendaten sowie Diagnoseprotokolle erforderlich. Mit der Einführung der Anwendungsnachrichtenerstellung in Version 9.4 können Sie in der Befehlszeile ein Datenerfassungstool ausführen, um Protokolle zu erfassen, die gemäß den Konfigurationsanweisungen für die Anwendungsnachrichtenerstellung generiert wurden. Vom Datenerfassungstool werden ebenfalls drei Textdateien erstellt:
  • readme.txt verdeutlicht die Verwendung, wenn das Problem auftritt.
  • problemDetails.txt ist eine Vorlagendatei, in die Sie Details zu einem Problem manuell eingeben können.
  • collectedInformation.txt ist ein Datensatz der automatisch erfassten Informationen zum Betriebssystem, zur Produktinformation von DOORS, zu den unterstützten DLL-Dateien (DLL = Dynamic Linked Library) und zur Datei config.ini.
Informationen zum Einrichten von Protokolldateien finden Sie in den folgenden Abschnitten:

Videosymbol Video

Jazz.net-Kanal
Kanal 'Software Education'

Lernsymbol Kurse

IoT Academy
Skills Gateway

Fragesymbol Community

Jazz.net
Jazz.net-Foren
Jazz.net-Bibliothek

Unterstützungssymbol Unterstützung

IBM Support Community
Bereitstellungs-Wiki