Start/notes.ini Parameters/EXTMGR_ADDINS

EXTMGR_ADDINS

Loads the listed Extension Manager libraries into the Extension Manager when Domino or Notes starts. There must be only one EXTMGR_ADDINS line in notes.ini — all libraries are listed comma-separated on the same line.

Profile

Parameter
EXTMGR_ADDINS
Syntax
EXTMGR_ADDINS=lib1,lib2,...
Value
Comma-separated list of library names (without path / without file extension)
Default
Empty (no additional Extension Manager loaded)
Scope
Domino server and Notes client
Category
General (C API / Extension Manager)
GUI equivalent
None (notes.ini only)
Related
EXTMGR_ADDIN_DIRECTORY (additional directory for add-in libraries)
Available since
9.0.1 (consistently in HCL C API documentation)

Description

  • Domino and Notes check notes.ini at startup for an EXTMGR_ADDINS entry and load all listed libraries into the Extension Manager.
  • An Extension Manager library registers its callback routines, which are called before and/or after defined Domino events (e.g. EM_NSFDBOPEN, EM_NSFNOTEUPDATE).
  • Typical use cases:
    • Antivirus (e.g. Trend Micro ScanMail for Domino, Symantec/Broadcom connectors)
    • Mail archiving & journaling (e.g. Dell SourceOne)
    • Audit, compliance, and custom add-ins
  • Most important rule: Only one EXTMGR_ADDINS= line may exist per notes.ini. Multiple lines cause the second line to overwrite the first — a typical configuration error when installing multiple third-party tools.
  • The libraries must be in the search path of the Domino/Notes program or in the directory additionally specified by EXTMGR_ADDIN_DIRECTORY.
  • Platform-specific extensions: Windows .dll, Linux/AIX .so, IBM i *SRVPGM. In EXTMGR_ADDINS, only the library name without extension is specified.

Example

Domino server with two add-ins (antivirus + custom audit):
EXTMGR_ADDINS=nSMDext,nAuditExt
Only a single add-in:
EXTMGR_ADDINS=nMyAddin

Notes

  • Changes to EXTMGR_ADDINS only take effect after restarting the server or Notes client.
  • For installations that themselves set EXTMGR_ADDINS=, always check whether a line already exists: if necessary, add the new library by comma to the existing line instead of creating a second line.
  • Order in the list can be relevant: Extension Managers are initialized in the specified order.
  • For problems (server hangs, crash at startup), the entry can be temporarily removed to isolate between Domino core and add-in.
  • The directory for add-in libraries can be extended via EXTMGR_ADDIN_DIRECTORY.

Sources (HCL Product Documentation)