Start/notes.ini Parameter/RTR_Logging

RTR_Logging

Steckbrief

Parameter
RTR_Logging
Kategorie
Cluster
Komponente
Server
Verfügbar seit
9.0.1 (und früher); HCL KB0037704 nennt explizit Domino 9.0.x, 10.0.x, 11.0.x und hö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 = aus (Standard) • 1 = Status-Meldungen aktivieren • höhere Werte = mehr Detail (laut HCL-Anleitung „Enabling the display of cluster replication status messages“)

Beschreibung

RTR_Logging aktiviert eine erweiterte Logging-Ausgabe des Cluster-Replikators (clrepl). Standardmäßig protokolliert ein Cluster-Server seine Replikationsaktivität stündlich oder auf Anforderung (tell clrepl log) — die Tiefe dieser Standard-Ausgabe ist begrenzt und nennt im Wesentlichen die replizierten Datenbanken zwischen Cluster-Servern.
Mit RTR_Logging=1 (oder höher) erscheinen zusätzliche Cluster-Replikator-Statusmeldungen auf der Server-Konsole und im Log:
  • aktueller Verarbeitungsstand der Cluster-Replikatorqueue,
  • Statistiken zur Replikation einzelner Datenbanken und Objekte,
  • detailliertere Fehlermeldungen bei abgewiesenen oder fehlgeschlagenen Replikationen.
In der HCL-KB KB0037704 „Additional Cluster Replication Logging Parameters“ wird RTR_Logging zusammen mit Log_Replication als Standard-Pfad zur tieferen Diagnose von Cluster-Replikationsproblemen empfohlen — vor allem dann, wenn die Standard-Ausgabe von Log_Replication allein nicht ausreicht. Die zugehörige Anleitung in der HCL Product Documentation heißt „Enabling the display of cluster replication status messages“.

Beispiel-Konfiguration

Cluster-Replikator-Statusmeldungen einschalten (typische Diagnose-Konfiguration):
RTR_Logging=1
Log_Replication=2
Laufzeit-Aktivierung über die Server-Konsole:
set config RTR_Logging=1
set config Log_Replication=2
Nach abgeschlossener Diagnose wieder zurückdrehen:
set config RTR_Logging=0
set config Log_Replication=1

Hinweise & Stolperfallen

  • Wirkt nur in Cluster-Servern; auf Nicht-Cluster-Servern erzeugt der Parameter keine zusätzlichen Ausgaben, da der clrepl-Task dort nicht läuft.
  • Erhöhte Werte können erhebliches Log-Volumen auf der Konsole und in log.nsf/console.log erzeugen — sinnvoll mit CONSOLE_LOG_MAX_KBYTES=… und gezielten Diagnosezeiträumen kombinieren.
  • Sollte zusammen mit Log_Replication=2 (oder höher) gesetzt werden, um auch die zugrunde liegende Replikator-Aktivität mit zu protokollieren.
  • Greift in der Regel sofort über set config RTR_Logging=…; ein Neustart ist nicht erforderlich.
  • Für das interaktive Anzeigen aktueller Cluster-Replikationsstatistik bietet Domino zusätzlich tell clrepl log und show stat replica.cluster.*.
  • Nach Abschluss der Diagnose explizit auf 0 zurücksetzen — sonst läuft das erhöhte Logging dauerhaft mit.

Quellen (HCL Product Documentation)