Start/notes.ini Parameter/EXTMGR_ADDINS

EXTMGR_ADDINS

Lädt die genannten Extension-Manager-Bibliotheken beim Start von Domino bzw. Notes in den Extension Manager. Es darf nur eine EXTMGR_ADDINS-Zeile in der notes.ini stehen — alle Bibliotheken werden kommasepariert in derselben Zeile aufgezählt.

Steckbrief

Parameter
EXTMGR_ADDINS
Syntax
EXTMGR_ADDINS=lib1,lib2,...
Wert
Kommaseparierte Liste von Bibliotheksnamen (ohne Pfad / ohne Dateiendung)
Default
Leer (kein zusätzlicher Extension Manager geladen)
Gültigkeitsbereich
Domino-Server und Notes-Client
Kategorie
Allgemein (C API / Extension Manager)
GUI-Entsprechung
Keine (nur notes.ini)
Verwandt
EXTMGR_ADDIN_DIRECTORY (zusätzliches Verzeichnis für Add-in-Bibliotheken)
Verfügbar seit
9.0.1 (durchgängig in HCL C API Doku)

Beschreibung

  • Domino und Notes prüfen beim Start die notes.ini auf einen EXTMGR_ADDINS-Eintrag und laden alle dort gelisteten Bibliotheken in den Extension Manager.
  • Eine Extension-Manager-Bibliothek registriert ihre Callback-Routinen, die vor und/oder nach definierten Domino-Events aufgerufen werden (z. B. EM_NSFDBOPEN, EM_NSFNOTEUPDATE).
  • Typische Anwendungsfälle:
    • Antivirus (z. B. Trend Micro ScanMail for Domino, Symantec/Broadcom-Konnektoren)
    • Mail-Archivierung & Journaling (z. B. Dell SourceOne)
    • Audit-, Compliance- und Custom-Add-ins
  • Wichtigste Regel: Pro notes.ini darf nur eine EXTMGR_ADDINS=-Zeile vorhanden sein. Mehrere Zeilen führen dazu, dass die zweite Zeile die erste überschreibt — typischer Konfigurationsfehler bei der Installation mehrerer Drittanbieter-Tools.
  • Die Bibliotheken müssen sich im Suchpfad des Domino-/Notes-Programms bzw. im durch EXTMGR_ADDIN_DIRECTORY zusätzlich angegebenen Verzeichnis befinden.
  • Plattformhängige Erweiterungen: Windows .dll, Linux/AIX .so, IBM i *SRVPGM. In EXTMGR_ADDINS wird nur der Library-Name ohne Endung angegeben.

Beispiel

Domino-Server mit zwei Add-ins (Antivirus + Custom-Audit):
EXTMGR_ADDINS=nSMDext,nAuditExt
Nur ein einzelnes Add-in:
EXTMGR_ADDINS=nMyAddin

Hinweise

  • Änderungen an EXTMGR_ADDINS werden erst nach Neustart des Servers bzw. Notes-Clients wirksam.
  • Bei Installationen, die selbst EXTMGR_ADDINS= setzen, immer prüfen, ob bereits eine Zeile existiert: gegebenenfalls die neue Bibliothek per Komma in die bestehende Zeile aufnehmen, statt eine zweite Zeile anzulegen.
  • Reihenfolge in der Liste kann relevant sein: Extension Manager werden in der angegebenen Reihenfolge initialisiert.
  • Bei Problemen (Server bleibt hängen, Crash beim Start) kann der Eintrag temporär entfernt werden, um zwischen Domino-Kern und Add-in zu isolieren.
  • Das Verzeichnis für Add-in-Bibliotheken kann per EXTMGR_ADDIN_DIRECTORY erweitert werden.

Quellen (HCL Product Documentation)