Mit Protokolldateien können Sie Fehler beheben, die auf dem IBM®
Rational
DOORS-Datenbankserver, dem Client, dem Interoperation Server, dem Rational
DOORS Web Access-Server oder dem Nachrichtenbroker 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 Rational
DOORS Web Access-Server, den Interoperation Server
und den Nachrichtenbroker
- Protokolle von Anwendungsnachrichten und das Dienstprogramm zur Datenerfassung
Diagnoseprotokoll für den Rational
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 Rational
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 Rational DOORS-Datenbankserver aktivieren
beschrieben.
Anmerkung: Aktivieren Sie die Datenbankprotokollierung nur für begrenzte Diagnosezeiträume, um
Leistungseinbußen zu verhindern.
Clientprotokollierung für Rational
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 Rational
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 Rational DOORS-Client aktivieren
beschrieben.
Protokollierung für Rational
DOORS Interoperation Server sowie Rational
DOORS Web Access-Server und Nachrichtenbroker
Von den Rational
DOORS Web Access-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
Rational
DOORS Interoperation Server, vom
Rational
DOORS Web Access-Server und vom 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
bei den zugehörigen Links zur Rational
DOORS Web Access-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 Rational
DOORS Web Access-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
Rational
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
Rational
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 Rational
DOORS:
- Protokollierung in Rational
DOORS Web Access: