Start/notes.ini Parameter/SMTPClientDebug

SMTPClientDebug

SMTPClientDebug schaltet das Mitschreiben der ausgehenden SMTP-Protokoll-Konversationen des Domino-Mail-Routers ein – also der Verbindungen, die Domino selbst zu fremden SMTP-Servern aufbaut, wenn er Mail per SMTP weiterleitet.

Steckbrief

Parameter
SMTPClientDebug
Komponente
Server (Router/SMTP-Client)
Kategorie
Mail / Router (Debug)
Verfügbar seit
9.0.x (gemäß KB0032184)
Default
0 (deaktiviert)
Werte
0 aus, 1 ein
Ausgabeziel
log.nsf → Bereich Miscellaneous Events (kein debug_outfile nötig)
Was wird protokolliert
SMTP-Kommandos und -Antworten, nicht der Nachrichtentext

Beschreibung

Wird SMTPClientDebug=1 gesetzt, schreibt der Domino-Router für jede ausgehende SMTP-Verbindung den High-Level-Protokoll-Dialog mit. Erfasst werden u. a.:
  • TCP-Verbindungsaufbau zum Ziel-MX,
  • HELO/EHLO-Handshake,
  • TLS-/STARTTLS-Aushandlung (Erfolg, Ablehnung, Cipher),
  • Authentifizierungsschritte (AUTH),
  • Envelope-Kommandos MAIL FROM, RCPT TO, DATA
  • Antwort-Codes der Gegenseite (z. B. 250, 354, 421, 554),
  • Verbindungsabbau (QUIT, Sockets, Timeouts).
Der eigentliche Nachrichtentext zwischen DATA/. wird nicht protokolliert – dafür ist ggf. SMTPSaveImportErrors (eingehend) bzw. ein anderer Trace zuständig.

Besonderheit gegenüber SMTPDebug/SMTPDebugIO

Laut KB0032184 ist SMTPClientDebug das einzige der Router-SMTP-Debug-Flags, das kein debug_outfile benötigt. Der Mitschnitt landet automatisch in der log.nsf im Bereich Miscellaneous Events. Für SMTPDebug und SMTPDebugIO ist hingegen ein debug_outfile=Pfad/Datei.txt Pflicht.

Beispiele

Aktivierung in der notes.ini (wirkt nach Router-/SMTP-Restart):
SMTPClientDebug=1
Dynamisch zur Laufzeit über die Server-Konsole:
set config SMTPClientDebug=1
tell router quit
load router
Deaktivieren – wieder auf 0 setzen und den Router neu laden:
set config SMTPClientDebug=0
tell router quit
load router

Hinweise

  • Nur ausgehende Richtung – Für eingehende SMTP-Konversationen ist SMTPDebug (Listener) bzw. SMTPDebugIO (Bytes/Inhalt) zuständig.
  • log.nsf wächst – Bei viel ausgehendem Mail-Verkehr werden viele Miscellaneous Events erzeugt. Nach dem Troubleshooting wieder ausschalten.
  • Datenschutz – Auch wenn der Nachrichteninhalt nicht erfasst wird, sind Envelope-Adressen (MAIL FROM, RCPT TO) personenbeziehbar und werden mitgeschrieben.
  • TLS-Probleme – Sehr nützlich, um STARTTLS-Fehler oder Zertifikats-Mismatches gegen externe SMTP-Empfänger zu erkennen.

Quellen (HCL Product Documentation)