Start/notes.ini Parameters/FTG_USE_SYS_MEMORY

FTG_USE_SYS_MEMORY

Parameter: FTG_USE_SYS_MEMORY
Short description: Has the FT engine (GTR) request memory directly from the operating system via malloc instead of from the Domino memory pool — eliminates typical memory-allocation errors.

Profile

Parameter
FTG_USE_SYS_MEMORY
Category
Performance / Memory
Component
Server
Available since
9.0.1 (older)
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
0 (default, Notes Memory Manager) / 1 (direct malloc calls to the OS)

Description

With FTG_USE_SYS_MEMORY=1, the FT engine (GTR – General Text Retrieval) requests the memory for full-text indexing and full-text search operations directly from the operating system (malloc) instead of obtaining it from the Domino memory pool. This bypasses the limitation of individual memory segments within the Domino memory manager and reduces the typical „Not enough memory for full text indexing or search" errors.
The parameter has a particular impact on databases with many numeric fields or large full-text indexes. It belongs to the classic tuning family from the HCL KBs KB0111912 and KB0038904 and is often recommended together with UPDATE_FULLTEXT_THREAD=1, which moves FT indexing into a separate thread.

Example configuration

Default (parameter not set) — Notes Memory Manager:
FTG_USE_SYS_MEMORY=0
Recommended tuning variant (OS memory directly):
FTG_USE_SYS_MEMORY=1
Classic combination with separate indexing thread:
UPDATE_FULLTEXT_THREAD=1
FTG_USE_SYS_MEMORY=1

Notes & pitfalls

  • Only effective on servers (FT indexing and FT search).
  • Classic companion parameter: UPDATE_FULLTEXT_THREAD=1 (separate thread for FT indexing).
  • Symptoms without tuning: console messages Memory allocation error. errcode = 3301 / errcode = 256 or Not enough memory for full text indexing or search.
  • Has long been proposed as default tuning by the DCT (Domino Configuration Tuner).
  • Monitoring: show stat FT.* on the server console.
  • Takes effect after a server restart (classic notes.ini parameter, read at boot).

Sources (HCL Product Documentation)