16.7 Verwenden von DSTrace

Um das DSTrace-Dienstprogramm in einer Linux-Umgebung auszuführen, führen Sie folgenden Befehl in der Servereingabeaufforderung aus:

/opt/novell/eDirectory/bin/ndstrace

Die vollständige Syntax für den ndstrace-Befehl lautet:

ndstrace [-l|-u|-c "command1;......"|--version] [-h <local_interface:port>] [--config-file <configuration_file_path>] [thrd <thread ID>] [svty <severity_level>] [conn <connection_ID>]

Das DSTrace-Dienstprogramm besteht aus drei Hauptkomponenten:

16.7.1 Grundfunktionen

Die Grundfunktionen von DSTrace sind:

  • Anzeigen interner eDirectory-Aktivitäts- und Fehlersuchmeldungen in Linux.

  • Einleiten begrenzter Synchronisierungsprozesse.

Sie können das DSTrace-Dienstprogramm entweder im UI-Modus oder im Befehlszeilenmodus ausführen. Standardmäßig wird DSTrace im UI-Modus ausgeführt. Geben Sie folgenden Befehl in der Eingabeaufforderung des Servers ein, um DSTrace im UI-Modus zu starten:

/opt/novell/eDirectory/bin/ndstrace

Geben Sie folgenden Befehl in der Eingabeaufforderung des Servers ein, um DSTrace im Befehlszeilenmodus zu starten:

/opt/novell/eDirectory/bin/ndstrace -l

Zum Ausführen der Grundfunktionen von DSTrace geben Sie unter Verwendung der folgenden Syntax Befehle an der Eingabeaufforderung des Servers ein:

ndstrace command_option

Die folgende Tabelle listet die Befehlsoptionen auf, die Sie eingeben können.

Option

Beschreibung

ON

Aktiviert den eDirectory-Überwachungsbildschirm mit den grundlegenden Meldungen der Ablaufverfolgung.

OFF

Deaktiviert den Überwachungsbildschirm.

ALL

Startet den eDirectory-Überwachungsbildschirm und zeigt alle Meldungen der Ablaufverfolgung an.

AGENT

Aktiviert den eDirectory-Überwachungsbildschirm mit den Meldungen der Ablaufverfolgung, die mit den Flaggen ON, BACKLINK, DSAGENT, JANITOR, RESNAME und VCLIENT übereinstimmen.

DEBUG

Aktiviert einen vordefinierten Satz von Meldungen der Ablaufverfolgung, die üblicherweise bei der Fehlersuche verwendet werden. Die gesetzten Flaggen sind ON, BACKLINK, ERRORS, EMU, FRAGGER, INIT, INSPECTOR, JANITOR, LIMBER, MISC, PART, RECMAN, REPAIR, SCHEMA, SKULKER, STREAMS und VCLIENT.

NODEBUG

Der Überwachungsbildschirm bleibt zwar aktiviert, aber alle vorher festgelegten Fehlersuchmeldungen werden deaktiviert. Mit dieser Option werden die Meldungen der Befehlsoption ON beibehalten.

16.7.2 Fehlersuchmeldungen

Wenn der DSTrace-Bildschirm aktiviert ist, werden die Informationen auf der Grundlage mehrerer Standardfilter angezeigt. Wenn Sie mehr oder weniger als die Standardinformationen anzeigen möchten, können Sie die Filter mit den Flaggen für die Fehlersuchmeldungen bearbeiten. Mit den Fehlersuchmeldungen können Sie den Status von eDirectory bestimmen und überprüfen, ob alles ordnungsgemäß funktioniert.

Jeder eDirectory-Prozess verfügt über eine Reihe von Fehlersuchmeldungen. Zum Anzeigen der Fehlersuchmeldungen für einen bestimmten Prozess verwenden Sie ein Pluszeichen (+) sowie den Prozessnamen oder die Option. Zum Deaktivieren der Anzeige für einen Prozess verwenden Sie ein Minuszeichen (-) sowie den Prozessnamen oder die Option. Es folgen einige Beispiele:

Meldung

Beschreibung

set ndstrace = +SYNC

Aktiviert die Synchronisierungsmeldungen.

set ndstrace = -SYNC

Deaktiviert die Synchronisierungsmeldungen.

set ndstrace = +SCHEMA

Aktiviert die Schemameldungen.

Sie können die Flaggen für die Fehlersuchmeldungen auch mit den booleschen Operatoren „&“ (UND) und „|“ (ODER) kombinieren. Die Syntax für die Steuerung der Fehlersuchmeldungen an der Serverkonsole lautet wie folgt:

set ndstrace = <trace_flag> [parameter]

In der nachfolgenden Tabelle werden die Ablaufverfolgungsflaggen für die Fehlersuchmeldungen beschrieben. Sie können Abkürzungen für jede Ablaufverfolgungsflagge eingeben.

Ablaufverfolgungsflagge

Beschreibung

ABUF

Meldungen und Informationen in Bezug auf eingehende und ausgehende Paketpuffer, die Daten enthalten, die gleichzeitig mit oder als Antwort auf eine eDirectory-Anforderung empfangen werden.

ALOC

Meldungen mit Details zur Arbeitsspeicherzuordnung.

AREQ

Meldungen in Bezug auf eingehende Anforderungen von anderen Servern oder Clients.

AUTH

Meldungen und Fehlerberichte in Bezug auf die Authentifizierung.

BASE

Fehlersuchmeldungen auf der niedrigsten Fehlersuchebene.

BLNK

Backlink- und eingehende Nachrufmeldungen und Fehlerberichte.

CBUF

Meldungen in Bezug auf ausgehende DS-Clientanforderungen.

CHNG

Cache-Änderungsmeldungen.

COLL

Status- und Fehlerberichte, die die Aktualisierungsinformationen eines Objekts betreffen, wenn die Aktualisierung kürzlich empfangen wurde.

CONN

Meldungen mit Informationen über die Server, zu denen Ihr Server eine Verbindung aufzubauen versucht, und über Fehler und Zeitüberschreitungen, die einen Verbindungsaufbau möglicherweise verhindern.

DNS

Meldungen über die in eDirectory integrierten DNS-Serverprozesse.

DRLK

Meldungen bezüglich Distributed Reference Link.

DVRS

Meldungen zu DirXML®-treiberspezifischen Bereichen, die von eDirectory möglicherweise bearbeitet werden.

DXML

Meldungen mit Details zu DirXML-Ereignissen.

FRAG

Meldungen vom NCP™-Fragmentierungsprogramm, das eDirectory-Meldungen in Meldungen in NCP-Größe aufteilt.

IN

Meldungen zu eingehenden Anforderungen und Prozessen.

INIT

Meldungen in Bezug auf die Initialisierung von eDirectory.

INSP

Meldungen in Bezug auf die Integrität von Objekten in der lokalen Datenbank des Ursprungsservers. Das Verwenden dieser Flagge führt zu einer verstärkten Beanspruchung des Festplattenspeichers, Arbeitsspeichers und Prozessors des Servers. Diese Flagge darf nicht aktiviert bleiben, es sei denn, Objekte werden beschädigt.

JNTR

Meldungen zu folgenden Hintergrundprozessen: Janitor, Reproduktionssynchronisierung und allgemeine Aktualisierung.

LDAP

Meldungen in Bezug auf den LDAP-Server.

LMBR

Meldungen, die sich auf den Limber-Prozess beziehen.

LOCK

Meldungen in Bezug auf die Verwendung und Änderung der Sperren der lokalen Datenbank des Ursprungsservers.

LOST

Meldungen in Bezug auf verlorene Einträge.

MISC

Meldungen von verschiedenen Quellen in eDirectory.

MOVE

Meldungen bezüglich des Verschiebens von Partitionen oder Teilbäumen.

NCPE

Meldungen, die den Server zeigen, der die Anforderungen der NCP-Ebene empfängt.

NMON

Meldungen in Bezug auf iMonitor.

OBIT

Meldungen vom Nachrufvorgang.

PART

Meldungen in Bezug auf Partitionsvorgänge von Hintergrundprozessen und von der Anforderungsverarbeitung.

PURG

Meldungen über den Tilgungsvorgang.

RECM

Meldungen in Bezug auf die Manipulation der Datenbank des Ursprungsservers.

RSLV

Berichte in Bezug auf die Verarbeitung der Anforderungen zur Namensauflösung.

SADV

Meldungen in Bezug auf die Registrierung von Baumnamen und Partitionen mit dem Service Location Protocol (SLP).

SCMA

Meldungen in Bezug auf den Schemasynchronisierungsprozess.

SCMD

Meldungen, die Details zu den schemabezogenen Vorgängen enthalten. Sie enthalten Details über die Eingangs- und die Ausgangssynchronisierung.

SKLK

Meldungen in Bezug auf den Reproduktionssynchronisierungsprozess.

SPKT

Meldungen in Bezug auf Informationen der NCP-Serverebene von eDirectory.

STRM

Meldungen in Bezug auf die Verarbeitung von Attributen mit einer Stream-Syntax.

SYDL

Meldungen mit weiteren Details während des Reproduktionsprozesses.

SYNC

Meldungen über den Eingangssynchronisierungsverkehr (was vom Server empfangen wird).

TAGS

Zeigt die Tag-Zeichenkette an, die die Trace-Option identifiziert, die das Ereignis generiert hat (für alle Zeilen des Trace-Prozesses).

THRD

Meldungen, die anzeigen, wann Hintergrundprozesse (Threads) beginnen und enden.

TIME

Meldungen über die transitiven Vektoren, die während des Synchronisierungsvorgangs verwendet werden.

TVEC

Meldungen in Bezug auf folgende Attribute: „Synchronisieren bis“, „Reproduktion bis“, „transitiver Vektor“.

VCLN

Meldungen in Bezug auf die Erstellung oder das Löschen von Verbindungen zu anderen Servern.

Beim Verwenden der Fehlersuchmeldungen in DSTrace werden Sie bemerken, dass einige der Ablaufverfolgungsflaggen hilfreicher sind als andere. Eine der beim technischen Support von NetIQ beliebtesten DSTrace-Einstellungen ist eigentlich ein Direktaufruf:

set ndstrace = A81164B91

Diese Einstellung aktiviert eine Gruppe Fehlersuchmeldungen.

16.7.3 Hintergrundprozesse

Zusätzlich zu den Fehlersuchmeldungen, die Sie bei der Überprüfung des Status von eDirectory unterstützen, stehen Ihnen eine Reihe von Befehlen zur Verfügung, mit denen die Ausführung der eDirectory-Hintergrundprozesse ausgelöst wird. Wenn Sie die Ausführung der Hintergrundprozesse auslösen möchten, geben Sie vor dem Befehl einen Stern (*) ein. Beispiel:

set ndstrace = *H

Bei einigen Hintergrundprozessen können Sie auch den Status, die Zeitsteuerung sowie die Prozesssteuerung ändern. Zum Ändern dieser Werte müssen Sie vor dem Befehl ein Ausrufezeichen (!) eingeben und einen neuen Parameter oder Wert eingeben. Beispiel:

set ndstrace = !H 15 (parameter_value_in_minutes)

Die Syntax für jede Anweisung zur Steuerung der Hintergrundprozesse von eDirectory lautet wie folgt:

set ndstrace = <trace_flag> [parameter]

In der nachfolgenden Tabelle werden die Ablaufverfolgungsflaggen für die Hintergrundprozesse, eventuell erforderliche Parameter sowie der Prozess beschrieben, der in den Ablaufverfolgungsflaggen angezeigt wird.

Ablaufverfolgungsflagge

Parameter

Beschreibung

*A

Keine

Setzt den Cache-Speicher für Adressen auf dem Ursprungsserver zurück.

*AD

Keine

Deaktiviert den Cache-Speicher für Adressen auf dem Ursprungsserver.

*AE

Keine

Aktiviert den Cache-Speicher für Adressen auf dem Ursprungsserver.

*B

Keine

Plant den Backlink-Vorgang so, dass mit der Ausführung auf dem Ursprungsserver in einer Sekunde begonnen wird.

!B

Uhrzeit

Legt das Intervall für den Backlink-Vorgang in Minuten fest.

Standardwert=1500 Minuten (25 Stunden) Bereich= 2 bis 10080 Minuten (168 Stunden)

*CT

Keine

Zeigt die Tabelle der ausgehenden Ursprungsserververbindungen und die aktuellen statistischen Informationen für diese Tabelle an. Diese Statistiken enthalten keine Informationen über die eingehenden Verbindungen von anderen Servern oder Clients zum Ursprungsserver.

*CTD

Keine

Zeigt im durch Komma getrennten Format die Tabelle der ausgehenden Ursprungsserververbindungen und die aktuellen statistischen Informationen für diese Tabelle an. Diese Statistiken enthalten keine Informationen über die eingehenden Verbindungen von anderen Servern oder Clients zum Ursprungsserver.

*D

Reproduktions-rootEntryID

Entfernt die angegebene lokale Eintrags-ID von der Liste „Alle Objekte senden“ des Ursprungsservers. Die Eintrags-ID muss ein Partitionsstammobjekt definieren, das spezifisch für die lokale Datenbank des Servers ist. Dieser Befehl wird in der Regel nur dann verwendet, wenn der Prozess „Alle Aktualisierungen senden“ unaufhörlich versucht, Aktualisierungen anzuzeigen, und dabei Fehler auftreten, weil ein Server nicht erreichbar ist.

!D

Uhrzeit

Legt das Intervall für Ein- und Ausgangssynchronisierungauf die angegebene Minutenzahl fest.

Standardwert: 24 Minuten. Bereich=2 bis 10080 Minuten (168 Stunden)

!DI

Uhrzeit

Legt das Intervall für Eingangssynchronisierung auf die angegebene Minutenzahl fest.

Standardwert=24 Minuten Bereich= 2 bis 10080 Minuten (168 Stunden)

!DO

Uhrzeit

Legt das Intervall für Ausgangssynchronisierungauf die angegebene Minutenzahl fest.

Standardwert=24 Minuten Bereich= 2 bis 10080 Minuten (168 Stunden)

*E

Keine

Initialisiert den Eintrags-Cache des Ursprungsservers neu.

!E

Keine

Plant die Ein- und Ausgangssynchronisierungsvorgänge, um mit der Ausführung zu beginnen.

!EI

Keine

Plant den Eingangssynchronisierungsvorgang, um mit der Ausführung zu beginnen.

!EO

Keine

Plant den ausgehenden Synchronisierungsvorgang, um mit der Ausführung zu beginnen.

*F

Keine

Plant den Prozess der allgemeinen Aktualisierung, der Teil des Janitor-Vorgangs ist, so, dass mit der Ausführung auf dem Ursprungsserver in fünf Sekunden begonnen wird.

!F

Uhrzeit

Legt das Intervall für die allgemeine Aktualisierung in Minuten fest.

Standardwert=240 Minuten (4 Stunden) Bereich= 2 bis 10080 Minuten (168 Stunden)

*FL

1-10

Legt die Anzahl der von DSTrace verwendeten fortlaufenden Protokolldateien fest. Wenn für diesen Parameter ein Wert größer 1 festgelegt wird, benennt DSTrace die Datei ndstrace.log auf dem Ursprungsserver in ndstrace1.log um, sobald sie die konfigurierte maximale Dateigröße erreicht hat, und erstellt eine neue Datei ndstrace.log. Wenn diese neue Datei wiederum die maximale Dateigröße erreicht hat, wird die vorige Datei ndstrace1.log in ndstrace2.log umbenannt und die neuere Datei ndstrace.log wird in ndstrace1.log umbenannt.

Dieser Prozess wird fortgeführt, bis DSTrace die mit dieser Option festgelegte maximale Anzahl fortlaufender Protokolldateien erreicht hat. Wenn die angegebene Grenze erreicht wird, werden die ältesten Protokolldateien gelöscht, sodass stets nur die festgelegte maximale Dateizahl beibehalten wird.

Sie können maximal 10 fortlaufende Protokolldateien konfigurieren. Standardmäßig muss DSTrace mindestens 1 fortlaufende Protokolldatei verwenden. Wenn Sie den Parameter auf 0 setzen, verwendet DSTrace einen Parameterwert von 1.

*G

Reproduktions-rootEntryID

Baut den Änderungs-Cache der festgelegten Stammpartitions-ID neu auf.

*H

Keine

Plant den Vorgang der Reproduktionssynchronisierung so, dass mit der Ausführung auf dem Ursprungsserver sofort begonnen wird.

!H

Uhrzeit

Legt das Intervall in Minuten für den Heartbeat-Synchronisierungsvorgang fest.

Standardwert=30 Minuten Bereich= 2 bis 1440 Minuten (24 Stunden)

*HR

Keine

Löscht den zuletzt gesendeten Vektor im Speicher.

*I

Reproduktions-rootEntryID

Fügt die angegebene lokale Eintrags-ID der Liste „Alle Objekte senden“ des Ursprungsservers hinzu. Die Eintrags-ID muss ein Partitionsstammobjekt definieren, das spezifisch für die lokale Datenbank des Servers ist. Der Reproduktionssynchronisierungs-Vorgang prüft die Liste "Alle Objekte senden". Wenn sich die Eintrags-ID eines Partitionsstammobjekts in der Liste befindet, synchronisiert eDirectory alle Objekte und Attribute in der Partition, unabhängig vom Wert des Attributs „Synchronisiert bis“.

!I

Uhrzeit

Legt das Intervall in Minuten für den Heartbeat-Synchronisierungsvorgang fest.

Standardwert=30 Minuten Bereich= 2 bis 1440 Minuten (24 Stunden)

*J

Keine

Plant den Tilgungsprozess, der Teil des Reproduktionssynchronisierungsvorgangs ist, so, dass mit der Ausführung auf dem Ursprungsserver begonnen wird.

!J

Uhrzeit

Legt das Intervall für den Janitor-Vorgang in Minuten fest.

Standardwert=2 Minuten Bereich=1 bis 10080 Minuten (168 Stunden)

*L

Keine

Plant den Limber-Vorgang so, dass mit der Ausführung auf dem Ursprungsserver in fünf Sekunden begonnen wird.

*M

Byte

Ändert die maximale Größe der Datei, die von der Datei ndstrace.log des Ursprungsservers verwendet wird. Der Befehl kann unabhängig vom Status der Fehlersuchdatei verwendet werden. Die festgelegten Byte müssen ein Dezimalwert zwischen 10000 Byte und 100 MB sein. Wenn der festgelegte Wert höher oder niedriger als der festgelegte Bereich ist, tritt keine Änderung ein.

!M

Keine

Gibt den maximal verfügbaren Arbeitsspeicher an, der von eDirectory verwendet wird.

!N

0|1

Legt die Namensform fest.

0=nur Hexadezimal 1=vollständige Dezimalform

*P

Keine

Zeigt die abstimmbaren Parameter und die jeweiligen Standardeinstellungen an.

*R

Keine

Setzt die Größe der Datei ndstrace.log auf null Byte zurück. Dieser Befehl entspricht dem Parameter SET beim Setzen der Länge der NDS-Ablaufverfolgungsdatei auf Null.

*S

Keine

Plant den Skulker-Prozess, bei dem überprüft wird, ob eine der Reproduktionen auf dem Server synchronisiert werden muss.

!SI

Uhrzeit

Legt das Intervall in Minuten für den eingehenden Schemasynchronisierungsvorgang fest.

Standardwert=24 Minuten Bereich= 2 bis 10080 Minuten (168 Stunden)

!SO

Uhrzeit

Legt das Intervall in Minuten für den ausgehenden Schemasynchronisierungsvorgang fest.

Standardwert=24 Minuten Bereich= 2 bis 10080 Minuten (168 Stunden)

!SIO

Uhrzeit

Deaktiviert den eingehenden Schemasynchronisierungsvorgang für die festgelegte Minutenzahl.

Standardwert=24 Minuten Bereich= 2 bis 10080 Minuten (168 Stunden)

!SO0

Uhrzeit

Deaktiviert den eingehenden Schemasynchronisierungsvorgang für die festgelegte Minutenzahl.

Standardwert=24 Minuten Bereich= 2 bis 10080 Minuten (168 Stunden)

*SS

Keine

Aktiviert eine sofortige Schemasynchronisierung.

*SSA

Keine

Plant den Vorgang der Schemasynchronisierung so, dass er sofort begonnen wird, und erzwingt die Schemasynchronisierung mit allen Zielservern. Dies gilt auch dann, wenn sie in den letzten 24 Stunden synchronisiert wurden.

*SSD

Keine

Setzt die Schemasynchronisierungsliste des Ursprungsservers zurück. Diese Liste gibt an, mit welchen Servern der Ursprungsserver während des Vorgangs der Schemasynchronisierung synchronisiert werden soll. Ein Server, auf dem keine Reproduktionen gespeichert sind, sendet eine Anforderung, die in der Zielliste eines Servers einzuschließen ist, auf dem eine Reproduktion mit seinen Serverobjekten enthalten ist.

*SSL

Keine

Druckt die Liste der Schemasynchronisierungen von Zielservern.

*ST

Keine

Zeigt die Statusinformation für die Hintergrundvorgänge auf dem Ursprungsserver an.

*STX

Keine

Zeigt die Statusinformation für Backlink-Vorgänge (externe Referenzen) auf dem Ursprungsserver an.

*STS

Keine

Zeigt die Statusinformation für die Schemasynchronisierungsvorgänge auf dem Ursprungsserver an.

*STO

Keine

Zeigt die Statusinformation für Backlink-Vorgänge (Nachrufe) auf dem Ursprungsserver an.

*STL

Keine

Zeigt die Statusinformation für die Limber-Vorgänge auf dem Ursprungsserver an.

!T

Uhrzeit

Legt das Intervall in Minuten für die Prüfung des Serverstatus „Hochgefahren“ fest.

Standardwert=30 Minuten Bereich=1 bis 720 Minuten (12 Stunden)

*U

Optionale ID des Servers

Wenn der Befehl keine Eintrags-ID enthält, wird der Status jedes Servers, der zuvor als heruntergefahren gekennzeichnet wurde, auf hochgefahren geändert. Wenn der Befehl eine lokale Eintrags-ID enthält, wird der Status des angegebenen Servers von Heruntergefahren auf Hochgefahren geändert. Eintrags-IDs sind für die Datenbank des Ursprungsservers spezifisch und müssen sich auf ein Objekt beziehen, das einen Server darstellt.

!V

Eine Liste

Führt die beschränkten eDirectory-Versionen auf. Falls keine Versionen aufgeführt sind, gibt es keine Beschränkungen. Die Versionen werden durch Komma getrennt.

*Z

Keine

Zeigt die gegenwärtig geplanten Aufgaben an.