🏠/notes.ini Parameter/SMTPNotesPort

SMTPNotesPort

Parameter: SMTPNotesPort
Kurzbeschreibung: Bindet den SMTP-Listener auf einen bestimmten Notes-NRPC-Port (und damit auf eine bestimmte IP-Adresse / NIC) auf Servern mit mehreren TCP/IP-Ports. Ohne Setzen dieser Variable verwendet der SMTP-Service den ersten in der notes.ini gelisteten Port.

Steckbrief

Parameter
SMTPNotesPort
Kategorie
Mail / Router
Komponente
Server
Verfügbar seit
Domino 6.0
GUI-Entsprechung
Nur notes.ini (keine direkte GUI)
Wertebereich
Name eines in der notes.ini konfigurierten Notes-NRPC-Ports
Default
nicht gesetzt → es wird der erste in der notes.ini definierte Notes-Port verwendet

Beschreibung

Auf Domino-Servern mit mehreren konfigurierten Notes-Ports (typischerweise auf Multi-Homed-Hosts mit mehreren NICs / IP-Adressen) listet die notes.ini in der Ports=-Direktive mehrere Port-Namen wie TCPIP, TCPIP2 etc. Jeder dieser Notes-Ports ist im Server-Dokument bzw. via <PortName>_TcpIpAddress an eine konkrete IP-Adresse gebunden.
Standardmäßig nutzen die Internet-Services (SMTP, POP3, IMAP, LDAP) den erstgenannten Notes-Port. Mit SMTPNotesPort=<PortName> wird der inbound SMTP-Listener explizit an einen bestimmten Notes-Port und damit an eine bestimmte IP-Adresse / NIC gebunden.
Analoge Variablen aus derselben Familie:
  • POP3NotesPort — POP3-Service
  • IMAPNotesPort — IMAP-Service
  • LDAPNotesPort — LDAP-Service
  • HTTPNotesPort — HTTP-Service
Gemeinsam erlauben sie es, jeden Internet-Service auf eine eigene NIC / IP-Adresse zu binden — typische Use Cases sind partitionierte Server, dedizierte Mail-NICs oder die Trennung von intern und extern erreichbaren Adressen.

Beispiel-Konfiguration

; Multi-Port-Server mit zwei NICs:
Ports=TCPIP,TCPIP2
TCPIP_TcpIpAddress=0,10.0.0.10:1352
TCPIP2_TcpIpAddress=0,10.0.0.20:1352

; SMTP-Listener explizit auf TCPIP2 (10.0.0.20) binden
SMTPNotesPort=TCPIP2
; Alle Mail-Protokolle gemeinsam auf den Mail-Port legen,
; LDAP auf den anderen Port:
SMTPNotesPort=MailNet
POP3NotesPort=MailNet
IMAPNotesPort=MailNet
LDAPNotesPort=TCPIP
Änderungen erfordern einen Restart des SMTP-Tasks (tell smtp quit / load smtp) bzw. einen Domino-Restart, damit der Listener auf der neuen IP gebunden wird.

Hinweise & Stolperfallen

  • Port-Name muss existieren: Der angegebene Port-Name muss in der Ports=-Direktive eingetragen und im Server-Dokument bzw. via notes.ini-IP-Binding (<PortName>_TcpIpAddress=…) konfiguriert sein. Ein Tippfehler oder Verweis auf einen nicht existierenden Port lässt den SMTP-Listener entweder fehlschlagen oder still auf den Default zurückfallen.
  • Reihenfolge in Ports=: Ohne SMTPNotesPort zählt die Reihenfolge in Ports= — dies wird oft übersehen, wenn nachträglich ein zweiter NRPC-Port hinzugefügt wird und plötzlich eine andere IP für SMTP verwendet wird.
  • Konsistenz mit der Server-Dokument-Konfiguration: Inbound-SMTP-Port-Status (Enabled/SSL) wird im Server-Dokument unter Ports → Internet Ports → Mail gepflegt. SMTPNotesPort legt nur die Bindung an die NIC fest, nicht den TCP-Port (Standard 25 / 465). Der TCP-Port wird über das Server-Dokument oder SMTPListenerPort gesteuert.
  • Restart erforderlich: Anders als viele andere Mail-Parameter wird SMTPNotesPort nicht durch tell router update config neu geladen — der SMTP-Task muss neu gestartet werden.
  • IPv6-Setups: In IPv6-Konfigurationen werden separate Notes-Ports oft pro Stack (IPv4 / IPv6) definiert. SMTPNotesPort zeigt dann auf den IPv6-fähigen Port (siehe HCL-Doku zu Examples of using NOTES.INI variables with IPv6).
  • Hinweis zur Doku-Lage: Die Variable wird in mehreren HCL-Knowledge-Articles sowie der HCL Notes-und-Domino-Wiki-Diskussion dokumentiert. Eine eigenständige Help-Seite gibt es nicht; sie wird in den IPv6-Beispielen und im Kontext der Multi-Port-Konfiguration referenziert.

Quellen (HCL Product Documentation)