Start/notes.ini Parameter/DEBUG_CONSOLE

DEBUG_CONSOLE

Parameter: DEBUG_CONSOLE
Kurzbeschreibung: Schreibt Debug-Ausgaben in das Konsolen-Fenster bzw. die Server-Konsole — Standard-Begleitparameter für nahezu jedes Domino-Debug-Setup (Auth, SAML, NRPC, LDAP).

Steckbrief

Parameter
DEBUG_CONSOLE
Kategorie
Logging / Debug
Komponente
Server, Client
Verfügbar seit
9.0.1 (und früher)
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI)
Mögliche Werte
0 = deaktiviert (Standard), 1 = aktiviert

Beschreibung

DEBUG_CONSOLE=1 schaltet die Ausgabe interner Debug-Meldungen an die Server-Konsole bzw. das Notes-Client-Konsolen-Fenster frei. Der Parameter ist selbst kein Subsystem-spezifischer Trace, sondern ein übergeordneter Aktivierungs-Schalter: erst wenn DEBUG_CONSOLE=1 (oder alternativ ein Debug_Outfile=… gesetzt) ist, werden Ausgaben anderer DEBUG_*-/Logging-Parameter wie Log_Authentication, WEBAUTH_VERBOSE_TRACE (Client-Seite), DEBUG_SAML, LDAPDebug u. v. m. tatsächlich sichtbar.
In HCL-Support-KBs zur Auth-Diagnose ist DEBUG_CONSOLE=1 Bestandteil nahezu jeder „Debug Settings"-Anweisung — z. B. KB0038983 „Debug settings for Notes Federated Login" und KB0086631 „Debug settings for SAML authentication".
Auf dem Notes-Client öffnet sich bei aktivem DEBUG_CONSOLE=1 ein zusätzliches Konsolen-Fenster, in dem laufende Debug-Ausgaben angezeigt werden. Auf dem Server wirken die Einträge in der bereits vorhandenen Server-Konsole bzw. landen — sofern aktiviert — zusätzlich im Konsolen-Log (Console_Log_Enabled=1).

Beispiel-Konfiguration

Server-seitig (typisches Auth-Debug-Bundle):
DEBUG_CONSOLE=1
Log_Authentication=1
WEBAUTH_VERBOSE_TRACE=1
Debug_Outfile=c:\debug\auth.txt
Laufzeit-Aktivierung:
set config DEBUG_CONSOLE=1
Deaktivierung nach Abschluss der Analyse:
set config DEBUG_CONSOLE=0
Client-seitig analog in der notes.ini des Notes-Clients (typischerweise zur Diagnose von Notes Federated Login, NRPC-Auth-Problemen, oder Designer/Debugger-Sessions).

Hinweise & Stolperfallen

  • Allein gesetzt erzeugt der Parameter noch keine Debug-Ausgabe — es braucht zusätzlich aktivierte themenspezifische Trace-Parameter (z. B. Log_Authentication, DEBUG_SAML, LDAPDebug).
  • Für persistente Aufzeichnung zusätzlich Debug_Outfile=… setzen — ohne Outfile geht der Konsolen-Inhalt nach Server-Restart verloren (sofern Console_Log_Enabled=1 nicht gesetzt ist).
  • Auf dem Notes-Client kann das aufgehende Konsolen-Fenster Endanwender irritieren — vor produktiver Nutzung mit dem User abstimmen.
  • Wirkt sofort über set config DEBUG_CONSOLE=1; ein Server-Neustart ist nicht erforderlich.
  • Nach abgeschlossener Diagnose immer wieder deaktivieren, da die Konsolen-Ausgabe Performance kostet (zusätzlich I/O bzw. UI-Refresh) und Logfiles unnötig wachsen lässt.

Quellen (HCL Product Documentation)