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 . 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. ProtokollebenenProtokollebene |
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:
- Protokollierung in DOORS:
- Protokollierung in DWA: