Start/notes.ini Parameters/NOTES_MAX_FILEHANDLES

NOTES_MAX_FILEHANDLES

🛠️
Parameter: NOTES_MAX_FILEHANDLES
Short description: Maximum number of concurrently open file handles for the Notes / Domino process – important for servers with many open NSFs.

Profile

Parameter
NOTES_MAX_FILEHANDLES
Category
Performance / Memory
Component
Server, Client
Available since
9.0
Supported versions
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
Integer, platform-dependent (typically 5000–30000)

Description

Every opened NSF file and every TCP connection consumes file handles. On servers with many mail databases, full-text indexes, or DAOS pools, the OS defaults can quickly become too small – Domino then reports “File system limit reached” or can no longer open new NSFs. NOTES_MAX_FILEHANDLES sets the upper bound for the Notes / Domino process. On Linux / AIX, the OS limit (ulimit -n, LimitNOFILE) must additionally be set high enough; otherwise it kicks in first.

Example configuration

NOTES_MAX_FILEHANDLES=30000

Notes & pitfalls

  • On Linux, be sure to raise the OS limit in parallel (e.g. LimitNOFILE=65535 in the systemd unit); otherwise the notes.ini value has no effect.
  • Takes effect after a server / client restart.
  • show stat Database.NSFFileHandles* and OS tools (lsof) show the actual usage.
  • Pairs with tuning the DB cache parameters (NSF_DbCache_*) and DAOS.