Start/notes.ini Parameter/SMTPDebugIO

SMTPDebugIO

SMTPDebugIO schaltet das Mitschneiden der vollständigen Bytes der eingehenden SMTP-Konversation ein – also nicht nur der Protokollkommandos (wie SMTPDebug), sondern inklusive Headers und Mail-Body im DATA-Block. Damit lassen sich MIME-, Encoding- und Body-Probleme detailliert analysieren.

Steckbrief

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

Detailstufen

Wert
Bedeutung
0
I/O-Logging deaktiviert (Default)
1
Minimales I/O-Logging (Verbindungsereignisse)
2
Info-Logging mit Byte-Zählern
3
Verbose: gesendete/empfangene Klartext-Daten
4
Vollständiger Byte-Mitschnitt inkl. Mail-Body und Headers
Die genauen Stufen variieren leicht je nach Domino-Version; Stufe 4 ist gemäß KB0032184 die ausführlichste und enthält den kompletten DATA-Inhalt.

Beschreibung

SMTPDebugIO ist die feinste eingehende Debug-Ebene am Domino-SMTP-Listener. Wo SMTPDebug die Protokoll-Befehle (EHLO, MAIL FROM, RCPT TO, DATA, ...) und Antwort-Codes mitschneidet, protokolliert SMTPDebugIO zusätzlich die rohen Daten auf der TCP-Verbindung – also Header, MIME-Boundaries, Base64-/QP-Codierung und ggf. den vollständigen Nachrichtentext.
Wie SMTPDebug benötigt SMTPDebugIO zwingend debug_outfile, da die Ausgabe nicht in der log.nsf landet, sondern in der konfigurierten Textdatei.

Beispiele

Voller Byte-Mitschnitt (Stufe 4):
SMTPDebugIO=4
debug_outfile=C:\\Domino\\Logs\\smtp_io.txt
Kombination mit SMTPDebug für eine umfassende Diagnose:
SMTPDebug=3
SMTPDebugIO=4
debug_outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/smtp_full.txt
Dynamisch über die Server-Konsole:
set config SMTPDebugIO=4
set config debug_outfile=C:\\Domino\\Logs\\smtp_io.txt
tell smtp quit
load smtp
Deaktivieren:
set config SMTPDebugIO=0
tell smtp quit
load smtp

Hinweise

  • Sehr große Dateien – Bei Stufe 4 wird jede empfangene Mail komplett ins Logfile geschrieben. Das Logfile wächst entsprechend schnell; nur kurz aktivieren.
  • Datenschutz / Compliance – Da der vollständige Mail-Inhalt (inkl. Anhänge in MIME-Codierung) protokolliert wird, ist ein SMTPDebugIO=4-Mitschnitt personenbezogene Daten im Sinne der DSGVO. Logfile entsprechend schützen oder zeitnah löschen.
  • Anhänge – Anhänge erscheinen Base64-codiert. Zur Analyse gegebenenfalls extrahieren und decodieren.
  • Reihenfolge der Aktivierung – Erst debug_outfile setzen, dann SMTPDebugIO, sonst gehen erste Daten verloren.
  • Kombination – Häufig zusammen mit SMTPDebug aktiviert; KB0032184 empfiehlt für Support-Cases die Kombination beider Parameter.

Quellen (HCL Product Documentation)