Bei der Protokollierung werden gewöhnliche Benutzeroperationen mit CM Server und CM-API-Anwendungen sowie alle dabei auftretenden Fehler aufgezeichnet. Protokolleinträge werden in der Ländereinstellung der Maschine erstellt oder in Englisch, wenn die Ländereinstellung der Maschine nicht unterstützt wird.
Standardmäßig ist die Protokollierung für CM Server auf die Stufe "INFO" eingestellt. Sie sollten auch die Protokollierung für Ihre CM-API-basierte Anwendung auf "INFO" einstellen.
Sie können Protokollpakete für die CM-API, WebSphere Application Server und "TSlogger" konfigurieren.
Die Protokollierung für die CM-API wird mit der Datei "logging.properties" in der JDK-Verzeichnisstruktur der JRE, die für die Ausführung Ihrer Anwendung verwendet wird, gesteuert. Lokalisieren Sie die Datei "logging.properties" im Verzeichnis "jre\lib" Ihres Java Development Kit (z. B. "C:\Program Files\IBM\WebSphere\AST\eclipse\jre\lib", "C:\jdk_5.0\jre\lib" oder "C:\Program Files\Java\jre1.5.0_06\lib").
Die Protokollierung ist standardmäßig inaktiviert, Sie sollten Sie auf der Stufe "INFO" aktivieren.
############################################################ # Globale Eigenschaften ############################################################ # # "handlers" gibt eine durch Kommas getrennte Liste von Protokoll-Handler-Klassen # an. Diese Handler werden beim Start der VM installiert. # Beachten Sie, dass diese Klassen im Klassenpfad des Systems angegeben sein müssen. # Standardmäßig wird nur ein ConsoleHandler konfiguriert, der nur Nachrichten # der Stufe "INFO" und höherer Stufen anzeigt. handlers = java.util.logging.ConsoleHandler # Um auch den FileHandler hinzuzufügen, müssen Sie stattdessen die folgende Zeile verwenden. #handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler # Standardmäßig verwendete globale Protokollstufe. # Gibt an, welche Arten von Ereignissen von allen Protokollfunktionen # protokolliert werden. Diese globale Protokollstufe kann in jedem Tool # durch eine toolspezfische Einstellung überschrieben werden. # Beachten Sie, dass der ConsoleHandler ebenfalls eine eigene Einstellung # für Protokollstufe hat, um die in der Konsole ausgegebenen Nachrichten zu begrenzen. # Mit der nächsten Zeile wird die Protokollierung auf der Stufe "INFO" aktiviert # (für alle Objekte von Protokollfunktionen). .level=INFO ############################################################ # Handler-spezifische Eigenschaften. # Beschreibt die spezifische Konfiguration für Handler. ############################################################ # CMLogger - Muss immer auf der Protokollstufe "INFO" aktiviert sein. # # Anwendungen, die die CM-API verwenden, müssen nicht gestoppt und erneut gestartet werden. Änderungen der # konfigurierten Datei "logging.properties" werden automatisch erfasst und innerhalb von 10 Sekunden umgesetzt. # # Mit den folgenden Zeilen wird die Protokollierung für das CMLogger-Objekt auf der Stufe "INFO" aktiviert, # die Protokollausgabedatei erhält den Namen "CMLogger[#].log" und wird in das Ausgangsverzeichnis des # angemeldeten Benutzers gestellt. Die Protokollausgabe wird in 40 Dateien, von denen jede auf 40.000.000 Byte # begrenzt ist, fortgeschrieben. An die aktuelle Protokollausgabedatei im Rotationssystem werden Protokolleinträge # angehängt, die in einem einfachen Format verfasst sind. # com.ibm.rational.stp.common.internal.util.CMLogger.level = INFO com.ibm.rational.stp.common.internal.util.LogHandler.pattern = %h/CMLogger%g.log com.ibm.rational.stp.common.internal.util.LogHandler.limit = 40000000 com.ibm.rational.stp.common.internal.util.LogHandler.count = 40 com.ibm.rational.stp.common.internal.util.LogHandler.append = true com.ibm.rational.stp.common.internal.util.LogHandler.formatter = java.util.logging.SimpleFormatter # CMTracer - Aktivieren Sie die folgenden Einträge (durch Entfernen der Kommentarzeichen) nur bei Bedarf, # da die Traceerstellung ressourcenintensiv sein kann. # # Anwendungen, die die CM-API verwenden, müssen nicht gestoppt und erneut gestartet werden. Änderungen der # konfigurierten Datei "logging.properties" werden automatisch erfasst und innerhalb von 10 Sekunden umgesetzt. # # Mit den folgenden Zeilen wird die Traceerstellung für das CMTracer-Objekt auf der Stufe "FINER" aktiviert, # die Traceausgabedatei erhält den Namen "CMTracer[#].log" und wird in das Ausgangsverzeichnis des # angemeldeten Benutzers gestellt. Die Traceausgabe wird in 40 Dateien, von denen jede auf 40.000.000 Byte # begrenzt ist, fortgeschrieben. An die aktuelle Traceausgabedatei im Rotationssystem werden Traceeinträge # angehängt, die in einem einfachen Format verfasst sind. # #com.ibm.rational.stp.common.internal.util.CMTracer.level = FINER #com.ibm.rational.stp.common.internal.util.TraceHandler.pattern = %h/CMTracer%g.log #com.ibm.rational.stp.common.internal.util.TraceHandler.limit = 40000000 #com.ibm.rational.stp.common.internal.util.TraceHandler.count = 40 #com.ibm.rational.stp.common.internal.util.TraceHandler.append = true #com.ibm.rational.stp.common.internal.util.TraceHandler.formatter = java.util.logging.SimpleFormatter
Diese Einstellungen bewirken, dass eine Protokolldatei mit dem Namen "CMLogger[#].log" erstellt wird (und eine Traceausgabedatei mit dem Namen "CMTracer[#].log", wenn die CMTracer-Einträge auf Kommentar gesetzt werden). Jede Datei befindet sich im Ausgangsverzeichnis des angemeldeten Benutzers ("[#]" steht für die Nummer der Datei im Rotationssystem). Die Ausgabe wird jeweils von Datei zu Datei fortgeschrieben, sobald eine Datei voll ist.
Die in der obigen Datei "logging.properties" verwendeten Einträge geben an, dass die Protokoll- und Tracedatensätze an das Ende der gültigen Datei angehängt werden sollen und dass jeder Eintrag in einfachem Format gespeichert werden soll. Änderungen in der Datei "logging.properties" werden von der CM-API-basierten Anwendung innerhalb von 10 Sekunden automatisch erfasst und berücksichtigt. Die Anwendung muss nicht gestoppt und erneut gestartet werden.
Wenn eine Protokollausgabedatei voll ist (das ist bei 40 MB der Fall), wird eine neue Datei erstellt, und die vorherige Datei wird umbenannt und enhält das Datum und die Zeitmarke der Dateirotation. Jede Datei enthält 40 MB Daten, und neue Einträge werden an die vorhandenen Einträge angehängt, auch nach Neustarts von Anwendungen. Wenn die Anzahl der Protokolldateien den Wert 40 erreicht, bewirkt die Rotation zu einer neuen Datei, dass die älteste Datei automatisch gelöscht wird.
Informationen zur Konfiguration der Java-Protokollierung finden Sie in der Java-Dokumentation zu "java.util.logging.Logger" und "java.util.logging.FileHandler" des Java Development Kit.
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties Ihr_Client-Java-Programm_das_CM-API_verwendet
http://<Servername>:<Portnummer_der_Administrationskonsole>/ibm/consoleFür diese Angaben gilt Folgendes: <Servername> ist der Name des CM-Server-Systems, und <Portnummer_der_Administrationskonsole> ist die Portnummer der Administrationskonsole (standardmäßig 12060 bei CM Server oder 9060 für andere Versionen von WebSphere Application Server).
Je nachdem, welcher Typ von WebSphere Application Server auf Ihrem CM-Server-System verwendet wird, können Sie Änderungen in Echtzeit vornehmen, ohne CM Server stoppen und erneut starten zu müssen. Auf den meisten Seiten für die Konfiguration der Protokollierung in der Administrationskonsole gibt es zwei Register: Konfiguration und Laufzeit.
Wählen Sie in der Konsole Fehlerbehebung->Protokollierung und Tracing aus, und wählen Sie dann den Server aus der Liste der zu konfigurierenden Server aus. Wählen Sie Detailstufe für Protokoll ändern aus, und klicken Sie dann auf das Register Laufzeit. Änderungen auf der Registerkarte Laufzeit werden wirksam, sobald Sie Ihre Änderungen speichern. Änderungen auf der Registerkarte Konfiguration werden erst wirksam, wenn Sie den Server erneut starten. Wählen Sie das Markierungsfeld Laufzeitänderungen an der Konfiguration ebenfalls speichern aus, wenn die Änderungen zwischen Serverneustarts bestehen bleiben sollen. Wählen Sie den Link Komponenten aus. Beachten Sie, dass "*=info" im Fenster bereits aufgeführt ist. Rufen Sie die Option "com.ibm.rational.*", und wählen Sie "com.ibm.rational.stp.*" aus. Wählen Sie die gewünschte Stufe aus, indem Sie auf die Option Nachrichten- und Trace-Stufen klicken. Klicken Sie auf OK, und klicken Sie dann auf den Link Speichern im Bereich Nachrichten im oberen Abschnitt der angezeigten Seite. Die Änderungen werden wirksam, ohne dass der Server erneut gestartet werden muss.
Wenn die Version oder Klasse von WebSphere Application Server auf Ihrem CM-Server-System kein Register "Laufzeit" für Konfigurationsänderungen in Echtzeit bereitstellt, verwenden Sie das Register "Konfiguration", und starten Sie den Server dann erneut, damit die gespeicherten Änderungen wirksam werden.
In der Datei "tslogger.properties" sind die Bereiche, in denen Änderungen durchgeführt werden können, sowie die gültigen Wertebereiche gekennzeichnet. Die Protokollierung ist standardmäßig auf der Stufe "INFO" aktiviert. Alle Nachrichten der Stufen "INFO", "WARNING" und "SEVERE" werden in der Protokolldatei aufgezeichnet. Protokolldateien werden durch Editieren der Datei "tslogger.properties" konfiguriert. Die Datei wird jedoch bei der Installation ordnungsgemäß konfiguriert, so dass keine Änderungen erforderlich sind.
Die Standardeinstellungen in der Datei "tslogger.properties" sind auf Werte eingestellt, für die keine Änderungen erforderlich sind. Wenn eine Ausgabedatei voll ist, wird die Ausgabe in der nächsten Datei fortgesetzt. Ist die maximale Anzahl der Dateien bei der Rotation erreicht, wird die älteste Datei gelöscht und durch die nächste Datei im Rotationssystem ersetzt.