Start/notes.ini Parameter/Retain_Mirror_Logs

Retain_Mirror_Logs

Parameter: Retain_Mirror_Logs
Kurzbeschreibung: Verhindert beim Server-Start das Löschen vorhandener Mirror-Console-Logs. Erst mit Retain_Mirror_Logs=1 bleiben die durch Console_Log_Mirror=1 erzeugten console1.log…console999.log über Server-Neustarts hinweg erhalten.

Steckbrief

Parameter
Retain_Mirror_Logs
Komponente
Server
Kategorie
Logging / Debug
Verfügbar seit
Domino 8.x; aktuell dokumentiert in HCL Domino 10.0.1–14.5.1
Wertformat
0 (Default, löschen) oder 1 (beibehalten)
Voraussetzung
Nur wirksam mit Console_Log_Mirror=1

Beschreibung

Wenn auf einem Domino-Server Console_Log_Mirror=1 aktiviert ist, erzeugt der Console-Log-Mirror-Task neben console.log zusätzliche, nummerierte Mirror-Dateien console1.log, console2.log, ... im Verzeichnis IBM_TECHNICAL_SUPPORT. So entsteht eine echte Log-Historie, statt nur zirkulär überschriebener Daten in console.log.
Laut HCL Domino 10.0.1 Documentation („Using console log mirroring“) gilt per Default beim Server-Start:
  • Der Mirror-Task löscht alle vorhandenen console<N>.log-Dateien.
  • Anschließend wird mit console1.log neu begonnen.
Mit Retain_Mirror_Logs=1 wird dieses Löschen unterbunden:
  • Die bisherigen console1.log, console2.log, ... bleiben unverändert erhalten.
  • Der Mirror-Task führt die Nummerierung fort und füllt die jeweils kleinste freie Nummer (existieren z. B. console1.log, console2.log, console4.log, wird nächstes Mal console3.log angelegt, danach console5.log).
  • Die maximale Anzahl bleibt bei 999 Dateien; danach beginnt Domino, bestehende Dateien wieder zu überschreiben.

Wann den Parameter setzen?

  • Forensik / Postmortem nach Crash oder Restart – Damit die Mirror-Historie nicht durch ein simples Restart verschwindet.
  • Operative Server, auf denen die Mirror-Dateien extern (z. B. per Logshipping, SIEM, Backup) abgeholt werden, bevor sie aufgeräumt werden dürfen.
  • Diagnose-Phasen mit zahlreichen Restarts (z. B. JVM-Tuning, Konfigurationsänderungen) – ohne Retain_Mirror_Logs=1 wären die Logs des vorherigen Laufs bei jedem Neustart weg.

Beispiel

Mirroring aktivieren und Backups über Server-Restarts hinweg behalten:
Console_Log_Enabled=1
Console_Log_Mirror=1
Console_Log_Max_Kbytes=100000
Retain_Mirror_Logs=1
Im laufenden Betrieb wachsen console.log, console1.log, console2.log, ... auf je 100 MB; nach einem Server-Neustart bleiben die alten Dateien erhalten und der Mirror-Task ordnet sich nahtlos in die nächste freie Nummer ein.

Hinweise

  • Aufräumen erforderlich – Domino löscht mit Retain_Mirror_Logs=1 gar nichts mehr. Bis zu 999 × Console_Log_Max_Kbytes Bytes können sich akkumulieren – bei 100 MB pro Datei theoretisch ~100 GB. Das Verzeichnis IBM_TECHNICAL_SUPPORT daher regelmäßig per OS-Job (cron, Scheduled Task) bereinigen oder ältere console<N>.log archivieren.
  • Nur in Verbindung mit Mirroring – Ohne Console_Log_Mirror=1 ist Retain_Mirror_Logs wirkungslos.
  • Änderung erst nach Restart – Der Parameter wirkt beim nächsten Server-Start.
  • Begleitparameter – Console_Log_Enabled, Console_Log_Mirror, Console_Log_Max_Kbytes, debug_outfile.

Quellen (HCL Product Documentation)