Start/notes.ini Parameter/Console_Log_Max_Kbytes

Console_Log_Max_Kbytes

Parameter: Console_Log_Max_Kbytes
Kurzbeschreibung: Legt die maximale Größe der Domino-Console-Logdatei (console.log) bzw. der zugehörigen Mirror-Dateien in Kilobyte fest. Beim Erreichen der Maximalgröße wird die Datei ringförmig überschrieben.

Steckbrief

Parameter
Console_Log_Max_Kbytes
Komponente
Server (auch Workstation/Notes Client)
Kategorie
Logging / Debug
Verfügbar seit
Domino 6.x; aktuell dokumentiert in HCL Domino 10.0.1–14.5.1
Wertformat
Ganzzahl in Kilobyte
Default ohne Mirroring
nicht gesetzt = unbegrenzt
Default mit Mirroring
100 000 KB (100 MB), Maximum 1 000 000 KB (1 GB)

Beschreibung

Domino schreibt seine Konsolenausgabe optional in die Datei IBM_TECHNICAL_SUPPORT/console.log. Solange Console_Log_Max_Kbytes nicht gesetzt oder auf 0 steht, wächst diese Datei unbegrenzt – was auf produktiven Servern problematisch ist (Plattenplatz, Lese-Performance bei Diagnosen).
Mit Console_Log_Max_Kbytes=<KB> legen Sie eine Obergrenze fest. Wird diese erreicht, beginnt Domino, neue Einträge am Anfang der Datei zu überschreiben (zirkuläres Logging). Es entsteht kein automatisches Roll-Over in eine zweite Datei – dafür ist Console_Log_Mirror=1 zuständig.

Verhalten in Kombination mit Mirroring

Laut HCL Domino 10.0.1 Documentation („Using console log mirroring“) gilt:
  • Ist Console_Log_Mirror=1 aktiv, ist der Default für Console_Log_Max_Kbytes 100 000 KB (100 MB).
  • Das Maximum beträgt 1 000 000 KB (1 GB).
  • Wird Console_Log_Max_Kbytes nicht angegeben, verhält sich Domino so, als sei Console_Log_Max_Kbytes=100000 gesetzt; der Wert wird allerdings nicht in die notes.ini zurückgeschrieben.
  • Beim Wrap der Hauptdatei wird ein neues Mirror-File console1.log, console2.log, ... erzeugt (siehe Console_Log_Mirror).

HCL-Empfehlung für Diagnose

HCL Customer Support empfiehlt in KB0086631 „Debug settings for SAML authentication with Domino web server“ bei länger laufenden Reproduktionen die Anhebung des Limits:
CONSOLE_LOG_MAX_KBYTES=50000
Damit fällt die console.log von Default-10 MB auf 50 MB an, was für verbose Debug-Ausgaben (DEBUG_SAML=31, WEBAUTH_VERBOSE_TRACE=1 etc.) typischerweise reicht.

Beispiele

50 MB Limit für Auth-/SAML-Diagnose:
Console_Log_Enabled=1
Console_Log_Max_Kbytes=50000
100 MB Limit zusammen mit Mirroring:
Console_Log_Enabled=1
Console_Log_Mirror=1
Console_Log_Max_Kbytes=100000

Hinweise

  • Wert in KB, nicht MB – 100000 bedeutet 100 000 KB ≈ 100 MB; ein versehentliches Console_Log_Max_Kbytes=100 würde nur 100 KB ergeben.
  • Wirkung erst nach Server-Restart – Änderungen werden beim nächsten Start übernommen.
  • Keine echte Rotation – Ohne Console_Log_Mirror=1 wird die Datei zirkulär überschrieben, nicht rotiert. Wer historische Logs braucht, muss Mirroring aktivieren.
  • Pfad – Mit debug_outfile lässt sich die console.log an einen anderen Ort verschieben.
  • Erfahrungswert aus Foren – In Einzelfällen wurde berichtet, dass nach Erreichen der Maximalgröße das Logging gänzlich stoppt; ggf. zusätzlich Mirroring nutzen, um diesen Effekt zu vermeiden.
  • Begleitparameter – Console_Log_Enabled, Console_Log_Mirror, Retain_Mirror_Logs, debug_outfile.

Quellen (HCL Product Documentation)