Start/notes.ini Parameter/DAOSCatalogState

DAOSCatalogState

DAOSCatalogState spiegelt den aktuellen Zustand des DAOS-Katalogs (daoscat.nsf) als Zahl in der notes.ini wider. Der Wert wird vom Server selbst geschrieben – administrative Änderungen erfolgen nicht durch direktes Editieren, sondern über die Konsole (tell daosmgr resync).

Steckbrief

Parameter
DAOSCatalogState
Komponente
Server
Kategorie
DAOS
Verfügbar seit
Domino 8.5; aktuell dokumentiert in HCL Domino 9.0.x–14.5.1
Wertformat
Ganzzahl 0, 1 oder 2 (vom Server gesetzt)
Manuell editierbar
Nein – nicht in der notes.ini verändern
GUI-Entsprechung
Konsolenkommando tell daosmgr status

Beschreibung

Der DAOS-Katalog ist die zentrale Indexdatenbank des Domino Attachment and Object Service. Solange der Katalog im Zustand Synchronized ist, kann DAOS NLO-Dateien zuverlässig anlegen, referenzieren und löschen.
DAOSCatalogState reflektiert genau diesen Zustand:
  • 0 – Down / Disabled: DAOS ist deaktiviert oder der Katalog ist nicht initialisiert. Auf einem frisch ohne DAOS aufgesetzten Server typischer Wert.
  • 1 – Needs Resync: Der Katalog muss synchronisiert werden, bevor er wieder zuverlässig arbeitet. Tritt z. B. nach abrupten Server-Stopps, defekten Backups oder Hardware-Fehlern auf.
  • 2 – Synchronized: Normalbetrieb. DAOS arbeitet konsistent.

Statusprüfung im Tagesgeschäft

Für operative Prüfungen ist DAOSCatalogState in notes.ini weniger geeignet als die Konsolen-Befehle:
  • tell daosmgr status – zeigt den Zustand und nützliche Statistiken.
  • show stat DAOS – ausführliche Statistiken zu Repository, Pruning, Resync.

Wenn der Status „Needs Resync“ auftritt

Laut HCL KB0031850 „Troubleshooting the DAOS Catalog »Needs Resync« state“ sind die typischen Schritte:
  1. Backup des betroffenen Servers/Volumes ziehen.
  1. tell daosmgr resync – sanfte Synchronisation starten.
  1. Wenn das nicht reicht: tell daosmgr resync force – erzwungene Synchronisation.
  1. Erst wenn auch das nicht hilft, weitere Diagnose (tell daosmgr dbdelete, KB0126234).
Nach erfolgreichem Resync wechselt DAOSCatalogState selbst auf 2.

Beispiele

Frisch konfigurierter DAOS-Server, nach erstem tell daosmgr resync:
DAOSEnable=1
DAOSBasePath=D:\DAOS
DAOSMinObjSize=4096
DAOSDeferredDeleteInterval=30
DAOSCatalogState=2
Server im Recovery-Status (vor manuellem Resync):
DAOSEnable=1
DAOSCatalogState=1

Hinweise

  • Niemals manuell setzen – Ein manuelles DAOSCatalogState=2 korrigiert keine echten Inkonsistenzen, kann sie aber kaschieren und spätere Datenkorruption verursachen.
  • daoscat.nsf nicht löschen – KB0079120 weist ausdrücklich darauf hin, dass das Löschen von daoscat.nsf und daos.cfg zur Behebung von Resync-Problemen die DAOS-Berechnungen zurücksetzt und das Löschen von NLO-Dateien stark verlangsamen kann.
  • Monitoring – Eignet sich gut, um per Monitoring-Skript zu prüfen, ob ein Server dauerhaft im Zustand 2 ist; alles andere ist ein Alarm.
  • Begleitparameter – DAOSEnable, DAOSBasePath, DAOSMinObjSize, DAOSDeferredDeleteInterval, DAOS_ENCRYPT_NLO, DAOS_LOAD.

Quellen (HCL Product Documentation)