Start/notes.ini Parameters/FTG_Index_Limit

FTG_Index_Limit

Parameter: FTG_Index_Limit
Short description: Maximum size of an individual document or attachment for full-text indexing; default 6 MB (Win/Linux), 1 MB (macOS).

Profile

Parameter
FTG_Index_Limit
Category
Performance / Memory
Component
Server
Available since
9.0.1
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 in MB; default 6 (Windows/Linux), 1 (macOS)

Description

FTG_Index_Limit defines the maximum size of an individual document or attachment that the Domino full-text indexer will still process. On Windows and Linux servers the default value is 6 MB, on macOS 1 MB. If a document or an attachment exceeds this threshold, the indexer skips its content and logs a message such as „Exceeded max configured index size" or „Brute Force Attachment Filtering" in the server console log.
In databases with many large PDF, Office, or ZIP attachments, the default value often results in many documents not being found by full-text search. Raising it — for example to 32 or 64 MB — ensures that larger attachments end up in the FT index, but increases index size, RAM usage of the FT tasks, and I/O load accordingly.

Example configuration

FTG_Index_Limit=32

Notes & pitfalls

  • The parameter applies to individual documents/attachments, not to the total size of the FT index of a database.
  • Increases should be planned together with adjustments to FTG_MB_PER_THREAD / FTG_MAX_MEM_POOL so that the indexer also has enough memory available for the larger files.
  • After an increase, affected FT indexes must be rebuilt with updall -f so that previously skipped documents are captured.
  • Very high values (≥ 256 MB) can cause long indexing runs and noticeably higher disk utilization on large servers.

Sources