Start/notes.ini Parameters/DEBUG_FAULT_RECOVERY

DEBUG_FAULT_RECOVERY

🛠️
Parameter: DEBUG_FAULT_RECOVERY
Short description: Writes additional diagnostic information to the console during a fault recovery operation (crash handling, NSD start, automatic restart).

Profile

Parameter
DEBUG_FAULT_RECOVERY
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

Description

If the Domino server falls into a serious error state, Fault Recovery kicks in: Domino collects diagnostic data (NSD), shuts the server down in a controlled way, and optionally restarts it automatically. DEBUG_FAULT_RECOVERY enables additional trace output during this sequence – which recovery steps were executed, whether NSD was written correctly, how long individual phases took, and whether the automatic restart was successful.
Important for analysis when fault recovery does not trigger as expected (e.g. server hangs instead of restarting, NSD is not generated, restart limit reached).

Example configuration

DEBUG_FAULT_RECOVERY=2

Notes & pitfalls

  • Takes effect only on the next crash or fault recovery run.
  • Entries appear in console.log and in the NSD accompanying files.
  • Complementary to FaultRecovery_* parameters (FaultRecovery_Build, FaultRecovery_MaxRestarts, ...).
  • For reproducible crashes, hand the output together with NSD to HCL Support.
  • Level 2 produces detailed output – take the disk usage of the logs into account.