Start/notes.ini Parameters/Debug_nif_update

Debug_nif_update

Profile

Parameter
Debug_nif_update
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 (default, disabled) | 1 (debug active)

Description

Debug_nif_update enables additional diagnostic output in the Notes Indexing Framework (NIF). With Debug_nif_update=1, on every update or rebuild of a view index, Domino logs the database name, view name, and triggering user to the server console as well as to log.nsf. Errors during a view rebuild are also additionally output.
The parameter is particularly helpful when analyzing frequent or unexpected view rebuilds, e.g. when HCL Support requests a diagnosis or phenomena such as „randomly discarded view indexes“ or „Blocked from updating“ are being investigated. In normal operation it should remain off, because the additional log lines can noticeably bloat the console log.

Example configuration

Debug_nif_update=1

Notes & pitfalls

  • Permanently enabled in production, console.log and log.nsf grow noticeably faster; after diagnosis is complete, the parameter should be reset to 0 or removed.
  • It is often enabled together with DEBUG_THREADID=1 so that updates can be uniquely assigned to the triggering threads.
  • Output appears in „Miscellaneous Events“ of the log file; there the update traces can be narrowed down to individual databases via filter expressions.
  • Takes effect immediately after set config Debug_nif_update=1; a server restart is not required.

Sources