Start/notes.ini Parameter/debug_outfile

debug_outfile

Parameter: debug_outfile
Kurzbeschreibung: Definiert den absoluten Pfad zu einer Textdatei, in die diverse Domino-Debug-Tasks ihre Ausgabe schreiben. Voraussetzung für SMTPDebug, SMTPDebugIO und zahlreiche weitere notes.ini-Debug-Flags.

Steckbrief

Parameter
debug_outfile
Komponente
Server (allgemein)
Kategorie
Logging / Debug
Verfügbar seit
9.0.x (gemäß KB0032184)
Default
nicht gesetzt
Werte
Vollständiger Pfad zu einer Datei (.txt, .log o. ä.)
Voraussetzung für
SMTPDebug, SMTPDebugIO (KB0032184) sowie zahlreiche weitere Debug-Flags

Beschreibung

Viele Domino-Debug-Parameter geben ihre Diagnose-Daten nicht in die log.nsf aus, sondern in eine zentrale Textdatei – genau die, deren Pfad in debug_outfile steht. Ohne debug_outfile:
  • werden SMTPDebug-/SMTPDebugIO-Mitschnitte verworfen oder gehen nur unvollständig in andere Logs ein,
  • liefern viele weitere Debug-Tasks (Replikation, Routing, Indexing) keinen sichtbaren Output.
Für SMTPDebug und SMTPDebugIO ist debug_outfile laut KB0032184 zwingende Voraussetzung. Für SMTPClientDebug ist debug_outfile dagegen nicht erforderlich, weil dort die Ausgabe direkt in log.nsf (Bereich Miscellaneous) erfolgt.

Beispiele

Windows:
debug_outfile=C:\\Domino\\Logs\\smtp_debug.txt
SMTPDebug=2
SMTPDebugIO=4
Linux/AIX:
debug_outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/smtp_debug.txt
SMTPDebug=2
SMTPDebugIO=4
Dynamisch zur Laufzeit setzen:
set config debug_outfile=C:\\Domino\\Logs\\smtp_debug.txt
set config SMTPDebug=2
tell smtp quit
load smtp

Hinweise

  • Verzeichnis muss existieren und für den Domino-Server-Prozess beschreibbar sein, sonst bleibt die Datei leer bzw. die Debug-Ausgabe verloren.
  • Datei wird angehängt – Domino schreibt typischerweise im Append-Modus. Bei längeren Diagnosesitzungen kann die Datei mehrere hundert MB erreichen; vor jedem Reproduktionslauf ggf. löschen oder rotieren.
  • Geteilte Datei – Wenn mehrere Debug-Tasks gleichzeitig auf dieselbe debug_outfile schreiben, sind die Einträge zwar zeitlich verschachtelt, aber typischerweise mit Präfix versehen, sodass sich die Quelle erkennen lässt.
  • HCL Support – Empfiehlt häufig den Pfad <notesdata>/IBM_TECHNICAL_SUPPORT/<komponente>_debug.txt, weil dieses Verzeichnis bei nsd automatisch in Diagnose-Pakete eingesammelt wird.
  • Datenschutz – Inhalte können personenbezogene Daten enthalten (Mail-Adressen, ggf. Mail-Bodies aus SMTPDebugIO=4); Datei nach Abschluss der Diagnose sicher löschen.
  • Nicht zu verwechseln mit Console_Log_File (steuert die Console-Logdatei) oder LOGFILE_DIR (HTTP-/Server-Logging-Verzeichnis).

Quellen (HCL Product Documentation)