Start/notes.ini Parameter/SMTPDebug

SMTPDebug

Parameter: SMTPDebug
Kurzbeschreibung: Aktiviert das Mitschreiben eingehender SMTP-Protokoll-Konversationen, die der Domino-SMTP-Listener von anderen Servern und Clients empfängt. Vier Detail-Stufen (1–4); benötigt zusätzlich debug_outfile=<Pfad> in der notes.ini.

Steckbrief

Parameter
SMTPDebug
Komponente
Server (SMTP-Listener)
Kategorie
Mail / Router (Debug)
Verfügbar seit
9.0.x (gemäß KB0032184)
Default
0 (deaktiviert)
Werte
0 (aus), 1, 2, 3, 4 (zunehmend ausführlich)
Benötigt zusätzlich
debug_outfile=<Pfad/Datei.txt> in der notes.ini
Ausgabeziel
Datei aus debug_outfile (nicht log.nsf)

Detailstufen laut KB0032184

Wert
Bedeutung
0
Logging deaktiviert (Default)
1
Minimales Listener-Logging
2
Info-Logging: gesendete/empfangene Daten, Anzahl Bytes, zusätzliche Debug-Information – ohne übertragenen Klartext
3
Verbose: zusätzlich der per SMTP übertragene Klartext (Kommandos und Antworten); kein Mail-Body
4
Maximale Detail-Stufe

Beschreibung

Während SMTPClientDebug die ausgehende Richtung erfasst, protokolliert SMTPDebug die eingehende Richtung am SMTP-Listener – also alles, was Fremdsysteme an Domino schicken: TCP-Verbindungsaufbau, EHLO/HELO, STARTTLS-Verhandlung, AUTH, MAIL FROM, RCPT TO, DATA, Antwort-Codes des Domino-Servers (250, 421, 550, 554 ...).
Laut KB0032184 schreibt SMTPDebug seine Ausgabe nicht in die log.nsf. Stattdessen muss in der notes.ini zusätzlich debug_outfile=<Pfad> gesetzt werden – dort entsteht eine Textdatei mit dem Mitschnitt. Ohne debug_outfile ist die Ausgabe verloren.

Beispiele

Mittlere Detail-Stufe in der notes.ini:
SMTPDebug=2
debug_outfile=C:\\Domino\\Logs\\smtp_debug.txt
Verbose-Mitschnitt zur Diagnose eines konkreten Problems:
SMTPDebug=3
debug_outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/smtp_debug.txt
Dynamisch über die Server-Konsole:
set config SMTPDebug=2
set config debug_outfile=C:\\Domino\\Logs\\smtp_debug.txt
tell smtp quit
load smtp
Deaktivieren – zurück auf 0:
set config SMTPDebug=0
tell smtp quit
load smtp

Hinweise

  • debug_outfile Pflicht – Ohne diesen zweiten Parameter wird kein SMTPDebug-Mitschnitt persistiert.
  • Datei kann groß werden – KB0032184 warnt: aktivieren Sie das Logging nur für die Dauer der Reproduktion.
  • Gegenstück für Inhalt – Für den vollständigen RFC822-Inhalt der Nachrichten ist SMTPDebugIO=4 zuständig.
  • Gegenstück für Outbound – Ausgehende SMTP-Verbindungen sind nicht durch SMTPDebug abgedeckt; dafür ist SMTPClientDebug=1 zuständig.
  • Datenschutz – Adressen, Headers und ggf. Klartext-Kommandos werden mitgeschrieben – personenbezogene Daten beachten.
  • Beenden mit set config ...=0 – KB0032184 erwähnt explizit, dass alle SMTP-Debug-Parameter über set config <name>=0 zur Laufzeit ausgeschaltet werden können; danach SMTP/Router-Tasks neu starten.

Quellen (HCL Product Documentation)