Start/notes.ini Parameter/NSF_DbCache_Maxentries

NSF_DbCache_Maxentries

Parameter: NSF_DbCache_Maxentries
Kurzbeschreibung: Maximale Anzahl an Datenbanken, die der Server gleichzeitig im Database-Cache offen hält.

Steckbrief

Parameter
NSF_DbCache_Maxentries
Kategorie
Performance / Memory
Komponente
Server
Verfügbar seit
9.0.1
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Server-Dokument → Performance → „Maximum cached databases“
Mögliche Werte
Ganzzahl, typisch 100 – 5000; Default abhängig von Server-Größe

Beschreibung

Der Database-Cache hält bereits geöffnete NSFs auf Server-Seite vor, sodass beim nächsten Zugriff der teure Open-Vorgang (inkl. Kollation, ACL, View-Index-Initialisierung) entfällt. NSF_DbCache_Maxentries setzt das Limit, wie viele Datenbanken sich gleichzeitig in diesem Cache befinden dürfen.
Ist der Wert zu klein, werden Datenbanken häufig aus dem Cache verdrängt und müssen neu geöffnet werden – das kostet CPU und I/O. Ist er zu groß, kann der Server unnötig viele Handles und Speicher binden.
Der Parameter korrespondiert mit dem Feld „Maximum cached databases“ im Server-Dokument; ein Eintrag in der notes.ini überschreibt die Server-Dokument-Einstellung.

Default-Berechnung

Ohne expliziten Eintrag ergibt sich der Wert laut HCL-Produktdokumentation aus NSF_Buffer_Pool_Size / 300 KB, mindestens jedoch 25. Das HCL Notes/Domino Wiki ergänzt: das Minimum sind 25, das plattform-abhängige Maximum liegt bei ca. 2000 Datenbanken im Cache. Kurzfristig speichert Domino bis zu 1,5× den eingestellten Wert (bei =1500 also bis zu 2.250).
Beobachtbar wird der aktive Wert über die Server-Statistik Database.DbCache.MaxEntries, die aktuelle Belegung über Database.DbCache.CurrentEntries und Engpässe über Database.DbCache.OvercrowdingRejections — jede Zurückweisung deutet darauf hin, dass der Cache zu klein ist.

Beispiel-Konfiguration

NSF_DbCache_Maxentries=1500

Hinweise & Stolperfallen

  • Werte werden erst nach Server-Neustart wirksam.
  • Aktuelle Auslastung mit show stat Database.Database.Cache.* prüfen, insbesondere Database.Database.Cache.CurrentEntries, Database.Database.Cache.HighWaterMark und Database.Database.Cache.OvercrowdingRejections.
  • Bei häufigen OvercrowdingRejections ist der Wert zu klein.
  • Sehr hohe Werte erfordern entsprechend dimensionierten NSF-Buffer-Pool und ausreichend File-Handles auf Betriebssystemebene.
  • Auf Mailservern mit vielen kleinen Mail-Files lohnt ein höherer Wert; auf Anwendungsservern mit wenigen, großen DBs ist ein niedrigerer Wert ausreichend.
  • Plattform-abhängige Obergrenze: Das HCL Notes/Domino Wiki nennt „approximately 2000“.
  • HCL Domino 14.5.1 hat keine eigene conf_nsf_dbcache_maxentries_r.html-Reference-Seite — der Parameter wird in 14.5.1 weiterhin im Hilfe-Topic Improving database and Domino Directory performance (tune_*_c.html) wortgleich beschrieben.

Quellen (HCL Product Documentation)