Start/notes.ini Parameter/TRANSLOG_Style

TRANSLOG_Style

Parameter: TRANSLOG_Style
Kurzbeschreibung: Bestimmt den Logging-Stil des Transaktionslogs: 0 = Circular (Default, max. 4 GB, zirkulär überschrieben), 1 = Archive (Logs werden archiviert, Voraussetzung für inkrementelle/Point-in-Time-Backups).

Steckbrief

Parameter
TRANSLOG_Style
Komponente
Server
Kategorie
Transaktionslog
Verfügbar seit
Domino 5.x; aktuell dokumentiert in HCL Domino 9.0.x–14.5.1
Wertformat
Ganzzahl
Mögliche Werte
0 = Circular (Default), 1 = Archive
GUI-Entsprechung
Server-Dokument → „Transactional Logging“ → „Logging style“

Beschreibung

Circular (TRANSLOG_Style=0, Default)

  • Domino verwendet bis zu 4 GB an Plattenplatz im Translog-Verzeichnis und überschreibt die ältesten Einträge ringförmig, sobald das Limit erreicht ist.
  • Vorteile: einfach, keine externe Backup-Software erforderlich, geringer administrativer Aufwand.
  • Nachteile: kein Point-in-Time-Recovery, kein inkrementelles Backup auf Translog-Basis. Geht eine Datenbank zwischen zwei Vollbackups verloren, sind nur die Daten bis zum letzten Vollbackup wiederherstellbar.
  • Geeignet, wenn das zwischen zwei Vollbackups anfallende Änderungsvolumen unter 4 GB bleibt.

Archive (TRANSLOG_Style=1)

  • Domino erzeugt Logdatei-Extents zu je 64 MB und behält sie, bis ein backup-fähiges Tool (HCL Domino Backup, Tivoli Storage Manager, Veritas, IBM Spectrum Protect for Domino, ...) sie als gesichert markiert hat. Erst dann werden die Extents wiederverwendet.
  • Vorteile: Point-in-Time-Recovery und inkrementelles Backup auf Translog-Basis möglich; Disaster-Recovery via TRANSLOG_Recreate_Logctrl=1 ist nur in diesem Modus zulässig.
  • Nachteile: benötigt eine darauf abgestimmte Backup-Lösung; ohne regelmäßiges Backup wird der Logbereich beliebig groß und kann das Translog-Volume füllen.
  • Empfohlen für produktive Server mit hoher Datenkritikalität.

Linear (nur GUI)

Im Server-Dokument gibt es zusätzlich die Option „Linear“. Sie verhält sich aus Sicht der notes.ini wie Circular (TRANSLOG_Style=0), erlaubt aber eine Logdateigröße über 4 GB hinaus (über TRANSLOG_MaxSize). HCL beschreibt das in der Domino 11.0.1 Documentation „Preparing for transaction logging“ als Lösung für Fälle, in denen mehr als 4 GB zwischen zwei Vollbackups anfallen, aber kein Archivmedium genutzt werden soll.

Wechsel von Circular auf Archive

Laut HCL KB0099512 „How to change the transaction logging style from ‘Circular’ to ‘Archived’“:
  1. Server-Dokument öffnen, Reiter „Transactional Logging“.
  1. „Logging style“ von „Circular“ auf „Archived“ stellen.
  1. Server-Dokument speichern und replizieren lassen.
  1. Domino-Server neu starten – Domino weist beim Umstellen jeder Datenbank eine neue DBIID zu, die alten DBIIDs sind ungültig.
  1. Vollbackup durchziehen, sobald der Server läuft. Innerhalb einer Minute nach dem Start werden die *.txn und logctrl.lfh neu erzeugt; bestehende inkrementelle Backups sind ohne dieses Vollbackup wertlos.

Beispiele

Circular für kleine bis mittlere Server:
TRANSLOG_Status=1
TRANSLOG_Style=0
TRANSLOG_Path=D:\Domino\txn
Archive für produktive Server mit Backup-Lösung:
TRANSLOG_Status=1
TRANSLOG_Style=1
TRANSLOG_Path=D:\Domino\txn
TRANSLOG_UseAll=0

Hinweise

  • DBIID-Wechsel – Jede Umstellung von Style erzeugt neue DBIIDs auf allen geloggten Datenbanken. Inkrementelle Backups, die auf alten DBIIDs basieren, sind danach nicht mehr verwendbar.
  • Archive ohne Backup-Tool ist gefährlich – Ohne Backup-Software, die Logs „freigibt“, läuft das Translog-Volume voll und Domino stoppt eingehende Schreibvorgänge.
  • Erst nach Restart wirksam – Änderungen an TRANSLOG_Style werden beim nächsten Server-Start aktiv.
  • Begleitparameter – TRANSLOG_Status, TRANSLOG_Path, TRANSLOG_MaxSize, TRANSLOG_Performance, TRANSLOG_AutoFixup, TRANSLOG_UseAll, TRANSLOG_MAX_ARCHIVE_EXTENTS, TRANSLOG_Recreate_Logctrl.

Quellen (HCL Product Documentation)