Novell Documentation: Novell Identity Manager 3 - Anzeigen von Identity Manager-Prozessen

2.12 Anzeigen von Identity Manager-Prozessen

Verwenden Sie DSTRACE zum Anzeigen von Identity Manager-Prozessereignissen. Dies ist jedoch nur bei Tests und bei der Fehlerbehebung in Identity Manager möglich. Wenn DSTRACE ausgeführt wird, während die Treiber in Produktion sind, wird die Nutzlast der Identity Manager-Server erhöht . Dies kann dazu führen, dass Ereignisse nur sehr langsam ausgeführt werden.

Zum Anzeigen von Identity Manager-Prozessen in DSTRACE werden dem Treibersatz und den Treiberobjekten Werte hinzugefügt. Dies erfolgt in Designer oder in iManager.

2.12.1 Hinzufügen von Trace-Stufen in Designer

Sie können dem Treibersatzobjekt oder einzelnen Treiberobjekten Trace-Stufen hinzufügen.

Treibersatz

Wählen Sie in Designer in einem geöffneten Projekt das Treibersatzobjekt in der Überblicksansicht aus.
Klicken Sie mit der rechten Maustaste, wählen Sie Properties (Eigenschaften) und klicken Sie dann auf 5. Trace.
Legen Sie die Parameter für das Tracing fest und klicken Sie auf OK. Weitere Informationen zu den Treibersatz-Trace-Parametern finden Sie in Tabelle 2-1.

Wenn Sie die Trace-Stufe für das Treibersatzobjekt festgelegt haben, werden alle Treiber in den DSTRACE-Protokollen angezeigt.

Tabelle 2-1 Treibersatz-Trace-Parameter

Parameter	Beschreibung
Treiber-Trace-Stufe	Je höher die Trace-Stufe des Treiberobjekts, desto mehr Informationen werden in DSTRACE angezeigt. Trace-Stufe 1 zeigt Fehler, aber nicht die Ursache für die Fehler an. Wenn Sie Informationen zur Passwortsynchronisierung anzeigen möchten, setzen Sie die Trace-Stufe auf 5.
XSL-Trace-Stufe	DSTRACE zeigt XSL-Ereignisse an. Diese Trace-Stufe wird nur bei der Fehlerbehebung in XSL-Formatvorlagen verwendet. Wenn keine XSL-Informationen angezeigt werden sollen, setzen Sie die Stufe auf 0.
Port für die Java-Fehlersuche	Ermöglicht Entwicklern den Einsatz eines Java-Fehlersuchprogramms (Debugger).
Java-Trace-Datei	Wenn dieses Feld einen Wert enthält, werden alle Java-Informationen für das Treibersatzobjekt in eine Datei geschrieben. Der Wert für dieses Feld ist der Patch für diese Datei. Solange die Datei angegeben wird, werden Java-Informationen in sie geschrieben. Wenn eine Fehlersuche in Java nicht erforderlich ist, lassen Sie dieses Feld leer.
Größenlimit der Trace-Datei	Ermöglicht Ihnen das Festlegen eines Größenlimits für die Java-Trace-Datei. Wenn Sie die Dateigröße auf „Unbegrenzt“ setzen, nimmt die Datei so lange an Größe zu, bis kein Festplattenplatz mehr vorhanden ist.

Treiber

Wählen Sie in Designer in einem geöffneten Projekt das Treiberobjekt in der Überblicksansicht aus.
Klicken Sie mit der rechten Maustaste, wählen Sie Properties (Eigenschaften) und klicken Sie dann auf 8. Trace.
Legen Sie die Parameter für das Tracing fest und klicken Sie auf OK. Weitere Informationen zu diesen Parametern finden Sie in Tabelle 2-2.

Wenn Sie nur für das Treiberobjekt die Parameter festlegen, werden nur Informationen für diesen Treiber im DSTRACE-Protokoll angezeigt.

Tabelle 2-2 Treiber-Trace-Parameter

Parameter	Beschreibung
Trace-Stufe	Je höher die Trace-Stufe des Treiberobjekts, desto mehr Informationen werden in DSTRACE angezeigt. Trace-Stufe 1 zeigt Fehler, aber nicht die Ursache für die Fehler an. Wenn Sie Informationen zur Passwortsynchronisierung anzeigen möchten, setzen Sie die Trace-Stufe auf 5. Wenn Sie Use setting from Driver Set (Einstellung aus Treibersatz übernehmen) wählen, wird der Wert aus dem Treibersatzobjekt übernommen.
Trace-Datei	Geben Sie den Namen einer Datei an, in die die Identity Manager-Informationen für den ausgewählten Treiber geschrieben werden. Wenn Sie Use setting from Driver Set (Einstellung aus Treibersatz übernehmen) wählen, wird der Wert aus dem Treibersatzobjekt übernommen.
Größenlimit der Trace-Datei	Ermöglicht Ihnen das Festlegen eines Größenlimits für die Java-Trace-Datei. Wenn Sie die Dateigröße auf „Unbegrenzt“ setzen, nimmt die Datei so lange an Größe zu, bis kein Festplattenplatz mehr vorhanden ist. Wenn Sie Use setting from Driver Set (Einstellung aus Treibersatz übernehmen) wählen, wird der Wert aus dem Treibersatzobjekt übernommen.
Trace-Name	Anstelle des Treibernamens wird Treiber-Trace-Meldungen der eingegebene Wert vorangestellt. Verwenden Sie diesen Parameter, wenn der Treibername sehr lang ist.

2.12.2 Hinzufügen von Trace-Stufen in iManager

Sie können dem Treibersatzobjekt oder einzelnen Treiberobjekten Trace-Stufen hinzufügen.

Treibersatz

Klicken Sie in iManager auf Identity Manager > Identity Manager-Überblick.
Wählen Sie das gewünschte Treibersatzobjekt aus und klicken Sie auf Suchen.
Klicken Sie auf den Namen des Treibersatzes.
Wählen Sie die Registerkarte Versch. für das Treibersatzobjekt.
Legen Sie die Parameter für das Tracing fest und klicken Sie auf OK. Weitere Informationen zu diesen Parametern finden Sie in Tabelle 2-1.

Treiber

Wählen Sie in iManager Identity Manager > Identity Manager-Überblick.
Wechseln Sie zu dem Treibersatzobjekt, in dem sich das Treiberobjekt befindet, und klicken Sie auf Suchen.
Klicken Sie auf die obere rechte Ecke des Treiberobjekts und anschließend auf Eigenschaften bearbeiten.
Wählen Sie die Registerkarte Versch. für das Treiberobjekt.
Legen Sie die Parameter für das Tracing fest und klicken Sie auf OK. Weitere Informationen finden Sie in Tabelle 2-2.

HINWEIS:Die Option Use setting from Driver Set (Einstellung aus Treibersatz übernehmen) ist in iManager nicht vorhanden.

2.12.3 Erfassen von Identity Manager-Prozessen in einer Datei

Um Identity Manager-Prozesse in einer Datei zu speichern, wird diese über den Parameter im Treiberobjekt oder über DSTRACE gespeichert. Der Parameter im Treiberobjekt ist der Trace-Datei-Parameter.

Mithilfe der folgenden Methoden können Sie Identity Manager-Prozesse über DSTRACE auf verschiedenen Betriebssystemplattformen erfassen und speichern.

NetWare

Verwenden Sie DSTRACE.NLM zum Anzeigen von Trace-Meldungen auf der Systemkonsole oder zum Speichern der Meldungen in einer Datei (SYS:\SYSTEM\DSTRACE.LOG). DSTRACE.NLM zeigt die Trace-Meldungen auf dem Bildschirm „DSTRACE Console“ an.

Geben Sie an der Serverkonsole DSTRACE.NLM ein.

Dadurch wird DSTRACE.NLM in den Arbeitsspeicher geladen.
Geben Sie an der Serverkonsole DSTRACE SCREEN ON ein.

Ermöglicht, dass Trace-Meldungen auf dem Bildschirm „DSTRACE Console“ angezeigt werden.
Geben Sie an der Serverkonsole DSTRACE FILE ON ein.

Erfasst die an „DSTRACE Console“ gesendeten Trace-Meldungen in DSTRACE.LOG.
Geben Sie an der Serverkonsole DSTRACE -ALL ein.

Dadurch werden alle Trace-Flaggen deaktiviert.
Geben Sie an der Serverkonsole DSTRACE +DXML DSTRACE +DVRS ein.

Zeigt die Identity Manager-Ereignisse an.
Geben Sie an der Serverkonsole DSTRACE +TAGS DSTRACE +TIME ein.

Zeigt die Tags und Zeitstempel der Meldung an.
Wechseln Sie zu „DSTRACE Console“ und achten Sie auf das zu übergebende Ereignis.
Wechseln Sie wieder zur Serverkonsole.
Geben Sie an der Serverkonsole DSTRACE FILE OFF ein.

Stoppt das Erfassen von Trace-Meldungen in der Protokolldatei. Das Protokollieren von Informationen in der Datei wird dadurch ebenfalls gestoppt.
Öffnen Sie die Datei DSTRACE.LOG in einem Texteditor und suchen Sie nach dem geänderten Ereignis oder Objekt.

Windows

Wählen Sie „Systemsteuerung > NDS Services > dstrace.dlm“ und klicken Sie auf Starten.

Das Fenster „NDS Server Trace Utility“ wird geöffnet.
Wählen Sie Bearbeiten > Optionen und klicken Sie anschließend auf Alle löschen.

Dadurch werden alle Standard-Flaggen gelöscht.
Wählen Sie DirXML und DirXML-Treiber.
Klicken Sie auf "OK".
Wählen Sie Datei > Neu.
Geben Sie den Dateinamen und den Speicherort an, an dem die DSTRACE-Informationen gespeichert werden sollen, und klicken Sie auf „Öffnen“.
Warten Sie, bis das Ereignis auftritt.
Wählen Sie Datei > Schließen.

Dadurch wird das Schreiben der Informationen in die Protokolldatei gestoppt.
Öffnen Sie die Datei in einem Texteditor und suchen Sie nach dem geänderten Ereignis oder Objekt.

UNIX

Geben Sie ndstrace ein, um das ndstrace-Dienstprogramm zu starten.
Geben Sie set ndstrace=nodebug ein.

Dadurch werden alle aktuell gesetzten Trace-Flaggen deaktiviert.
Geben Sie set ndstrace on ein.

Dadurch werden die Trace-Meldungen an der Konsole angezeigt.
Geben Sie set ndstrace file on ein.

Dadurch werden alle Trace-Meldungen in der Datei ndstrace.log erfasst, die sich in dem Verzeichnis befindet, in dem eDirectory installiert ist. Dies ist standardmäßig /var/nds.
Geben Sie set ndstrace=+dxml ein.

Zeigt die Identity Manager-Ereignisse an.
Geben Sie set ndstrace=+dvrs ein.

Dadurch werden die Identity Manager-Treiberereignisse angezeigt.
Warten Sie, bis das Ereignis auftritt.
Geben Sie set ndstrace file off ein.

Dadurch wird das Protokollieren der Informationen in der Datei gestoppt.
Geben Sie exit ein, um das ndstrace-Dienstprogramm zu beenden.
Öffnen Sie die Datei in einem Texteditor. Suchen Sie nach dem geänderten Ereignis oder Objekt.

iMonitor

Mit iMonitor können Sie DSTRACE-Informationen über einen Webbrowser abrufen. Dabei spielt es keine Rolle, wo Identity Manager ausgeführt wird. iMonitor wird über die folgenden Dateien ausgeführt:

NDSIMON.NLM - läuft unter NetWare.
NDSIMON.DLM - läuft unter Windows.
ndsimonitor - läuft unter UNIX.

Greifen Sie auf iMonitor über „http://server_ip:8008/nds“ zu.

Der Standardport ist Port 8008.
Geben Sie einen Benutzernamen und ein Passwort mit Administratorrechten ein und klicken Sie auf Login (Anmeldung).
Wählen Sie auf der linken Seite Trace Configuration (Trace-Konfiguration).
Klicken Sie auf Clear all (Alle löschen).
Wählen Sie DirXML und DirXML Drivers (DirXML-Treiber).
Klicken Sie auf Trace On (Trace ein).
Wählen Sie auf der linken Seite Trace History (Trace-Verlauf).
Klicken Sie auf das Dokument mit der Änderungszeit „Aktuell“, um einen Live-Trace zu sehen.
Ändern Sie das Aktualisierungsintervall, wenn die Informationen häufiger angezeigt werden sollen.
Wählen Sie Trace Configuration (Trace-Konfiguration) auf der linken Seite und klicken Sie auf Trace Off (Trace aus), um das Tracing zu deaktivieren.
Sie können den Trace-Verlauf anzeigen, indem Sie die Option „Trace History“ (Trace-Verlauf) wählen. Die Dateien werden anhand ihres Zeitstempels unterschieden.

Wenn Sie eine Kopie der HTML-Datei benötigen, finden Sie diese an ihrem Standardspeicherort:

NetWare: SYS:\SYSTEM\ndsimon\DSTRACE*.htm
Windows: Laufwerksbuchstabe_:\Novell\NDS\ndsimon\dstrace\*.htm
UNIX: /var/nds/dstrace/*.htm