Start/notes.ini Parameters/DEBUG_FTI

DEBUG_FTI

🛠️
Parameter: DEBUG_FTI
Short description: Debug output for the full-text indexer (update/updall) – reports per-database start/end, document count, and errors during index build or incremental update.

Profile

Parameter
DEBUG_FTI
Category
Logging / Debug
Component
Server
Available since
10.0
Supported versions
10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
0 = off (default), 1 = basic, 2 = verbose (per document)

Description

While DEBUG_FT mainly targets the FT search API and the NSF interface, DEBUG_FTI (Fulltext Indexer) focuses on the index lifecycle itself: When is an FT index built, rebuilt, incrementally updated? Which databases are processed? How many documents per run? Are there errors when writing the index?
Ideal for diagnosing when update/updall runs unusually long, individual FT indexes are not updated, or an index is missing after database operations.

Example configuration

DEBUG_FTI=2
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/fti_debug.log

Notes & pitfalls

  • Level 2 is very verbose (one line per document).
  • Entries appear in console.log and in Debug_Outfile.
  • Takes effect immediately via set config DEBUG_FTI=...; a restart is not strictly required.
  • Complementary to DEBUG_FT, Update_*, FT_* parameters.
  • For index rebuild, additionally use updall -F (force rebuild) or updall -X (delete index).