Start/notes.ini Parameters/DEBUG_FT

DEBUG_FT

🛠️
Parameter: DEBUG_FT
Short description: Detailed tracing of full-text indexing and search – shows update, re-index, and query operations as well as errors in the FT subsystem.

Profile

Parameter
DEBUG_FT
Category
Logging / Debug
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
0 = off (default), 1 = on

Description

Full-text indexing (updall, update) creates and maintains FT indexes for NSF databases. DEBUG_FT=1 enables detailed trace output for all FT operations – which database is currently being indexed, which notes are processed, which queries are submitted and how they are resolved, as well as errors during index build or corruption.
This switch is typically used for problems such as FT index is not updated, FT search returns no or incorrect hits, or updall -F aborts.

Example configuration

DEBUG_FT=1
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/ft_debug.log

Notes & pitfalls

  • Very chatty – enable only temporarily.
  • Entries appear in console.log and in Debug_Outfile.
  • Takes effect immediately via set config DEBUG_FT=1; a restart is not strictly required.
  • Complementary to DEBUG_FTI (index lifecycle) and Update_* parameters.
  • For index corruption, additionally use updall -F and compact -c.