Start/notes.ini Parameter/Console_Log_Mirror

Console_Log_Mirror

Parameter: Console_Log_Mirror
Kurzbeschreibung: Aktiviert das Console-Log-Mirroring: Domino startet einen zusätzlichen Server-Thread, der jede Konsolenausgabe parallel in nummerierte Mirror-Dateien (console1.log, console2.log, …) schreibt und so eine echte Log-Historie statt nur zirkulären Überschreibens ermöglicht.

Steckbrief

Parameter
Console_Log_Mirror
Komponente
Server
Kategorie
Logging / Debug
Verfügbar seit
Domino 8.x; aktuell dokumentiert in HCL Domino 10.0.1–14.5.1
Wertformat
0 (aus, Default) oder 1 (an)
Wirkung
Erzeugt Mirror-Dateien console1.log…console999.log im Verzeichnis IBM_TECHNICAL_SUPPORT

Beschreibung

Ohne Mirroring schreibt Domino seine Konsolenausgabe nur in die einzelne Datei IBM_TECHNICAL_SUPPORT/console.log und überschreibt sie zirkulär, sobald Console_Log_Max_Kbytes erreicht ist. Damit ist die Historie verloren.
Mit Console_Log_Mirror=1 wird ein zusätzlicher Server-Thread „Console Log Mirror Task“ gestartet, der jeden Eintrag aus der console.log parallel in eine Mirror-Datei kopiert. Sobald die console.log ihr Limit erreicht und gewrapt wird, schließt der Mirror-Task die aktuelle Backup-Datei und legt eine neue mit fortlaufender Nummer an: console1.log, console2.log, ..., maximal bis console999.log. Es wird jeweils die kleinste freie Nummer verwendet (existiert z. B. nur console10.log, wird als nächstes console9.log, danach console11.log angelegt).

Implizite Auswirkungen

Laut HCL Domino 10.0.1 Documentation („Using console log mirroring“):
  • Mirroring aktiviert automatisch zirkuläres Logging in der Hauptdatei.
  • Der Default für Console_Log_Max_Kbytes wird auf 100 000 KB (100 MB) gesetzt; das Maximum beträgt 1 000 000 KB (1 GB).
  • Wird Console_Log_Max_Kbytes nicht explizit gesetzt, verhält sich Domino so, als sei Console_Log_Max_Kbytes=100000 gesetzt – der Wert wird allerdings nicht in die notes.ini zurückgeschrieben.
  • Tastenanschläge auf der Server-Konsole werden ebenfalls in die Logs gespiegelt (z. B. Backspaces sichtbar).

Verhalten beim Server-Restart

  • Default: Beim Start des Domino-Servers werden alle console<N>.log-Dateien gelöscht und nur die aktuelle console.log plus eine neue console1.log neu angelegt.
  • Mit zusätzlich gesetztem Retain_Mirror_Logs=1 bleiben die bisherigen Mirror-Dateien erhalten.

Fehlerfall

Falls der Mirror-Task ausfällt oder mehr als 3 Sekunden zurückfällt (Lese-/Schreibfehler, I/O-Druck), schaltet Domino das Mirroring automatisch ab und protokolliert in console.log:
Console Log Mirror Task has been disabled
Mirroring bleibt anschließend bis zum nächsten Server-Neustart deaktiviert.

Beispiele

Mirroring aktivieren mit Default-Limit (100 MB pro Datei):
Console_Log_Enabled=1
Console_Log_Mirror=1
Mirroring mit explizitem Limit von 200 MB pro Mirror-Datei und beibehaltenen Backups:
Console_Log_Enabled=1
Console_Log_Mirror=1
Console_Log_Max_Kbytes=200000
Retain_Mirror_Logs=1

Hinweise

  • Plattenplatz – Mit Mirroring können bis zu 999 × Console_Log_Max_Kbytes Dateien anfallen. Bei 100 MB pro Datei sind das theoretisch ~100 GB. Das Verzeichnis IBM_TECHNICAL_SUPPORT regelmäßig auf Wachstum kontrollieren oder Retain_Mirror_Logs weglassen.
  • Linux-Tipp – Auf Linux-Systemen empfiehlt sich, IBM_TECHNICAL_SUPPORT (oder via debug_outfile nur die console.log) auf ein dediziertes/tmpfs-Volume zu legen, um die Datenbank-Disk vom Logging-I/O zu entlasten.
  • Änderung erst nach Restart – Wirkung von Console_Log_Mirror tritt erst nach Server-Neustart in Kraft.
  • Begleitparameter – Console_Log_Enabled, Console_Log_Max_Kbytes, Retain_Mirror_Logs, debug_outfile.

Quellen (HCL Product Documentation)