Start/notes.ini Parameter/TRANSLOG_AutoFixup

TRANSLOG_AutoFixup

Parameter: TRANSLOG_AutoFixup
Kurzbeschreibung: Steuert, ob Domino bei Translog-Recovery-Fehlern automatisch ein Fixup auf der betroffenen Datenbank ausführt: 1 = automatischer Fixup (Default), 0 = Datenbank wird stattdessen für den Zugriff blockiert.

Steckbrief

Parameter
TRANSLOG_AutoFixup
Komponente
Server, auch Notes-Client
Kategorie
Transaktionslog
Verfügbar seit
Domino 5.x; aktuell dokumentiert in HCL Domino 9.0.x–14.5.1
Wertformat
Boolean (0 / 1)
Default
1 (automatischer Fixup an)
GUI-Entsprechung
nur notes.ini (kein direktes Feld im Server-Dokument)

Beschreibung

Domino führt beim Server-Start oder beim Erstzugriff auf eine geloggte Datenbank ein Translog-Replay aus, um die Datei in einen konsistenten Zustand zu bringen. Schlägt das fehl (z. B. wegen beschädigtem Translog, fehlendem Extent oder strukturell defekter NSF), entscheidet TRANSLOG_AutoFixup das weitere Vorgehen:

TRANSLOG_AutoFixup=1 (Default)

  • Domino führt automatisch ein Fixup -J auf der betroffenen Datenbank aus.
  • Fixup -J repariert die NSF und nimmt sie wieder online; ggf. werden korrupte Dokumente verworfen oder als unleserlich markiert.
  • Die Aktion landet in console.log und in log.nsf.
  • Empfohlen für Server und Notes-Clients, auf denen kontinuierliche Verfügbarkeit wichtiger ist als die manuelle Prüfung jedes Schadenfalls.

TRANSLOG_AutoFixup=0

  • Domino führt keinen automatischen Fixup durch.
  • Die betroffene Datenbank wird blockiert; Zugriffe darauf liefern Fehler wie „Database is being repaired“ oder „File is corrupt“.
  • Der Administrator muss manuell entscheiden (Fixup, Restore aus Backup, neu replizieren).
  • Sinnvoll auf Servern mit kritischen Datenbeständen, wo ein automatischer Fixup zwar Verfügbarkeit bringt, aber Datenverlust kaschieren könnte.

Empfehlung Notes-Client (Daniel Nashed)

Für Translog auf einem Notes-Client wird typischerweise gesetzt:
TRANSLOG_AutoFixup=1 TRANSLOG_UseAll=0 TRANSLOG_Style=0 TRANSLOG_Performance=2 TRANSLOG_Status=1 TRANSLOG_MaxSize=256 TRANSLOG_Path=c:\translog
Die Standardempfehlung ist 1, weil ein einzelner beschädigter Mailfile-Eintrag auf einem Client selten den Aufwand eines manuellen Eingriffs rechtfertigt.

Beispiele

Server-Standardkonfiguration:
TRANSLOG_Status=1 TRANSLOG_Style=1 TRANSLOG_Path=D:\Domino\txn TRANSLOG_AutoFixup=1 TRANSLOG_Performance=2
Kritischer Archive-Server, der nach Recovery-Fehler manuell beurteilt werden soll:
TRANSLOG_Status=1 TRANSLOG_Style=1 TRANSLOG_Path=D:\Domino\txn TRANSLOG_AutoFixup=0 TRANSLOG_Performance=2

Hinweise

  • Erst nach Restart wirksam – TRANSLOG_AutoFixup wird beim nächsten Server-Start aktiv.
  • Fixup -J kann Daten verwerfen – In Einzelfällen verwirft Fixup beschädigte Dokumente. Für kritische Daten lieber Restore aus Backup ziehen.
  • Keine Server-Dokument-Entsprechung – Im Gegensatz zu TRANSLOG_Style oder TRANSLOG_Path ist dieser Parameter nicht im Server-Dokument abgebildet.
  • BegleitparameterTRANSLOG_Status, TRANSLOG_Path, TRANSLOG_Style, TRANSLOG_Performance, TRANSLOG_MaxSize, TRANSLOG_UseAll.

Quellen (HCL Product Documentation)