Start/notes.ini Parameters/FT_INDEX_ATTACHMENTS

FT_INDEX_ATTACHMENTS

Parameter: FT_INDEX_ATTACHMENTS
Short description: Controls the full-text indexing of attachments server-wide (1 = without filter, 2 = never, 3 = with Tika filters).

Profile

Parameter
FT_INDEX_ATTACHMENTS
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
not set (database property decides, default) | 1 | 2 | 3

Description

FT_INDEX_ATTACHMENTS controls server-wide whether and how attachments are considered during full-text indexing. If the parameter is not set, the individual database property applies („Index attached files“ in the full-text index properties of the database). If set, it overrides the database property for all indexed databases on the server.
Values from Domino 14.5:
  • FT_INDEX_ATTACHMENTS=1 — Attachments in every indexed database without conversion filter (brute-force text stripping). Fast, but unreliable for Office and PDF attachments.
  • FT_INDEX_ATTACHMENTS=2 — Attachments are never indexed server-wide, even if the database property provides for it.
  • FT_INDEX_ATTACHMENTS=3 — Attachments in every indexed database with conversion filters (Tika), brute-force stripping only for file types from the internal brute-force list.
The parameter complements the finer control via FT_INDEX_FILTER_ATTACHMENT_TYPES, FT_USE_MY_ATTACHMENT_WHITE_LIST and FT_INDEX_FILTER_ATTACHMENT_TYPES_MAX_MB.

Example configuration

FT_INDEX_ATTACHMENTS=3

Notes & pitfalls

  • If the parameter is set, its specification applies to all databases on the server — the database property then has no effect.
  • Value 1 also indexes binary files as text and can unnecessarily inflate the index and enrich search results with garbage; in most environments, 3 is the better choice.
  • Interaction with FT_INDEX_FILTER_ATTACHMENT_TYPES: A custom whitelist should be activated with FT_USE_MY_ATTACHMENT_WHITE_LIST=1, otherwise it is ignored.
  • Changes only take effect after a rebuild of the FT indexes (updall -f); without rebuild, existing indexes remain unchanged.

Sources