Start/notes.ini Parameters/DEBUG_ODS

DEBUG_ODS

🛠️
Parameter: DEBUG_ODS
Short description: Debug output for ODS upgrades (compact -c) and ODS-specific operations – shows per NSF the old/new version and upgrade errors.

Profile

Parameter
DEBUG_ODS
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 block)

Description

The On-Disk Structure (ODS) determines the internal NSF data format. When upgrading to newer Domino versions (e.g. ODS 52 → 53 → 54 → 55), every NSF is typically converted to the new ODS using compact -c -ODS. DEBUG_ODS=1 enables debug output during these operations – which NSF was migrated from which ODS version to which new version, how long the upgrade took, and whether errors occurred.
Necessary for topics such as NSF remains stuck on old ODS, compact -c -ODS fails, individual databases cannot be opened after upgrade.

Example configuration

DEBUG_ODS=2
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/ods_debug.log
Create_R12_Databases=1

Notes & pitfalls

  • Level 2 writes a lot of entries during large compact runs.
  • Takes effect immediately via set config DEBUG_ODS=...; a restart is not strictly required.
  • Entries appear in console.log and in Debug_Outfile.
  • Complementary to Create_R*_Databases, NSF_DbCache_Maxentries, compact_* parameters.
  • Check the ODS version per NSF with show database <name>.