Start/notes.ini Parameter/TRANSLOG_Path

TRANSLOG_Path

Parameter: TRANSLOG_Path
Kurzbeschreibung: Legt den Pfad fest, in dem Domino seine Transaktionslog-Dateien (*.TXN, logctrl.lfh) ablegt. Entspricht dem Feld „Log path“ im Server-Dokument (Reiter „Transactional Logging“). HCL empfiehlt eine eigene gespiegelte Platte.

Steckbrief

Parameter
TRANSLOG_Path
Komponente
Server
Kategorie
Transaktionslog
Verfügbar seit
Domino 5.x; aktuell dokumentiert in HCL Domino 9.0.x–14.5.1
Wertformat
Absoluter Verzeichnispfad
Default
<DataDir>/LOGDIR
GUI-Entsprechung
Server-Dokument → „Transactional Logging“ → „Log path“

Beschreibung

Ist Transaktionslogging über TRANSLOG_Status=1 aktiviert, schreibt Domino jede Datenbankänderung zuerst in einen sequentiellen Logdatei-Strom unter TRANSLOG_Path. Dort liegen:
  • S0000000.TXN, S0000001.TXN, ... – die einzelnen Logdatei-Extents zu je 64 MB (HCL KB0032176).
  • logctrl.lfh – die Steuerdatei, die den Zustand des Logs beschreibt (Recovery-Point, aktive Extents, DBIID-Mapping).
Der Pfad wird beim Aktivieren des Logs aus dem Feld „Log path“ im Server-Dokument in die notes.ini übernommen. Änderungen am Server-Dokument allein reichen nicht: Domino schreibt sie zwar in die notes.ini, das eigentliche Verschieben der Dateien muss aber vom Administrator durchgeführt werden.

Performance-Empfehlung

Laut HCL KB0032176 „Transactional Logging and how it operates“ gilt:
  • Die Logdateien müssen auf einer eigenen physischen Platte liegen, nicht nur auf einer eigenen Partition desselben Volumes.
  • Empfohlen ist ein gespiegeltes Device (RAID 0 oder 1) mit eigenem Controller – das schafft sequentielle Schreibgeschwindigkeit und Datenintegrität.
  • Mit dediziertem Volume liegt der Gewinn typischerweise bei 10–20 % Performance.
  • Liegt das Translog auf demselben physischen Datenträger wie die NSFs, kann die Performance um bis zu 60 % einbrechen, weil die Schreibköpfe zwischen Log und Datenbanken hin- und herspringen müssen.

Wechsel des Pfads (Previous_TRANSLOG_Path)

Wenn das Logverzeichnis verschoben wird (Migration auf neue Hardware, anderes Volume), benötigt Domino vorübergehend beide Pfade:
TRANSLOG_Path=G:\logdir
Previous_TRANSLOG_Path=F:\logdir\
Der Parameter Previous_TRANSLOG_Path zeigt auf den alten Pfad, damit Domino beim nächsten Start eventuell vorhandene Logs noch lesen und Recovery durchführen kann. Nach erfolgreichem Server-Start und einem vollständigen Backup kann der Eintrag Previous_TRANSLOG_Path aus der notes.ini gelöscht werden (HCL KB0074352, KB0075378).

Vorgehen für Pfad-Wechsel (HCL KB0074352)

  1. Server-Dokument im Reiter „Transactional Logging“ öffnen.
  1. „Log path“ auf den neuen Pfad setzen und speichern.
  1. Änderung auf den Server replizieren lassen.
  1. Domino-Server stoppen.
  1. Inhalte des alten Logverzeichnisses (*.TXN, logctrl.lfh) auf das neue Volume kopieren.
  1. In der notes.ini Previous_TRANSLOG_Path entfernen.
  1. Server starten und ein Vollbackup ziehen.

Beispiele

Windows mit dediziertem Volume:
TRANSLOG_Status=1
TRANSLOG_Path=D:\Domino\txn
TRANSLOG_Style=0
TRANSLOG_Performance=2
Linux mit dediziertem Volume:
TRANSLOG_Status=1
TRANSLOG_Path=/local/translog
TRANSLOG_Style=1
TRANSLOG_Performance=2

Hinweise

  • Eigenes physisches Volume Pflicht – Translog auf der NSF-Platte degradiert die Performance massiv (KB0032176).
  • Erst nach Restart wirksam – Änderungen an TRANSLOG_Path werden beim nächsten Server-Start aktiv. Achtung: Falscher Pfad führt zu Recovery-Fehlern, daher Pfad vor Server-Start auf Existenz und Schreibrechte prüfen.
  • Berechtigungen – Der Domino-Service-Account braucht Vollzugriff auf das Verzeichnis. Auf Linux z. B. chown notes:notes /local/translog und chmod 700.
  • DBIID-Wechsel – Beim Pfadwechsel ändert Domino in der Regel nicht automatisch die DBIID; ein Vollbackup nach dem Umzug ist trotzdem dringend empfohlen, damit zukünftige inkrementelle Backups konsistent sind.
  • Begleitparameter – TRANSLOG_Status, TRANSLOG_Style, TRANSLOG_MaxSize, TRANSLOG_Performance, TRANSLOG_AutoFixup, TRANSLOG_UseAll, Previous_TRANSLOG_Path.

Quellen (HCL Product Documentation)