Start/notes.ini Parameters/NLCACHE_SIZE

NLCACHE_SIZE

🛠️
Parameter: NLCACHE_SIZE
Short description: Size (in bytes) of the server's name lookup cache – caches results of lookups against the Domino Directory.

Profile

Parameter
NLCACHE_SIZE
Category
Performance / Memory
Component
Server
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
Size in bytes (e.g. 8388608 = 8 MB)

Description

Domino performs a great many name lookups against the Domino Directory – for authorization checks, mail routing resolution, group expansion. A well-sized lookup cache (NLCACHE_SIZE) significantly reduces the load on the Directory because recurring queries are answered from memory. The value is specified in bytes; on large, heavy user / mail servers, 16–64 MB is common practice. Values that are too small lead to noticeably higher Directory IO; values that are too large waste memory.

Example configuration

NLCACHE_SIZE=16777216

Notes & pitfalls

  • The value is in bytes – do not accidentally write it in MB.
  • Takes effect after a server restart.
  • Use show stat NameLookup* (or show stat NLCache*) to monitor cache hit rate and tune the value iteratively.
  • For dynamic directories (frequent membership changes), do not size the cache too large – otherwise stale results stay around longer (see LDAP_Disable_QRCache).