Server_Pool_Tasks – NRPC-Worker-Thread-Pool pro Notes-Port

Parameter: Server_Pool_Tasks

Kurzbeschreibung: Legt die Größe des NRPC-Worker-Thread-Pools pro Notes-Port fest. Default: 40 Threads pro Port. Skaliert die Anzahl gleichzeitiger NRPC-Anfragen, die der server-Task abarbeiten kann. Steuert zusammen mit Server_Max_Concurrent_Trans das Thread-Pool-Verhalten.

Steckbrief

Parameter	`Server_Pool_Tasks`
Kategorie	Performance (NRPC-Threading)
Komponente	Server (`server`-Task / NRPC-Listener)
Verfügbar seit	8.5
Unterstützte Versionen	9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung	Nur notes.ini (keine GUI)
Mögliche Werte	Ganzzahl ≥ 20. Default: 40 (pro aktivem Notes-Port). Typische Erhöhung: 60–100.

Beschreibung

Server_Pool_Tasks und Server_Max_Concurrent_Trans regeln gemeinsam das Thread-Pool-Verhalten der NRPC-Schicht — also nserver.exe (Windows) bzw. server (Unix). Andere Tasks (HTTP, IMAP, Router, LDAP) sind davon nicht betroffen.

Wie der Pool funktioniert:

Pro Notes-Port legt Domino einen eigenen Worker-Thread-Pool an. Werden also drei Notes-Ports betrieben (z. B. TCPIP, ClusterPort, Spare), entstehen drei unabhängige Pools mit je Server_Pool_Tasks Threads.

Bei Default 40 + drei Ports also 120 Worker-Threads plus Overhead-Threads.

Worker-Threads bearbeiten NRPC-Transaktionen (Datenbank-Reads, View-Queries, Indexer-Anfragen aus Clients, Replikations-Antworten an andere Server).

Wann erhöhen?

Sehr viele gleichzeitige Notes-Clients (≥ mehrere hundert aktive User).

Hohe RPC-Last durch Add-ons / Backend-Apps, die viele kleine Calls machen.

Hub-Server, der gleichzeitig viele Replikations-Verbindungen empfängt.

Symptome eines Engpasses:

show stat Server.Trans.Total und Server.Trans.PerMinute zeigen hohe Last, während Server.Trans.Queue.Length und Server.Trans.Queue.MaxLen ungewöhnlich hoch werden.

Anwender melden „Hourglass"-Pausen, Mail-Datenbanken öffnen verzögert.

Konsolen-Befehl show stat Server.Pools.* (sofern verfügbar) zeigt ausgeschöpfte Thread-Pools.

Pro-Port-Limit beachten: Domino erlaubt keine unterschiedlichen Pool-Größen pro Notes-Port (Stand 11/12/14). Wer Server_Pool_Tasks=80 setzt, bekommt 80 auf jedem aktiven Port. HCL empfiehlt dazu in KB0037705 wörtlich:

It is highly recommended to configure no more than 100 threads total across all Notes Ports.

Bei drei aktiven Notes-Ports entspricht das also höchstens Server_Pool_Tasks≈33 — die HCL-Empfehlung bezieht sich explizit auf die Summe über alle Ports, nicht auf den Wert pro Port.

Beziehung zu Server_Max_Concurrent_Trans: Letzteres begrenzt parallele aktive Transaktionen. Default Server_Max_Concurrent_Trans=20. Für stark parallelisierte Server beide gemeinsam hochsetzen, z. B. Server_Pool_Tasks=80 + Server_Max_Concurrent_Trans=40.

Beispiel-Konfiguration

Großer Mehrport-Server:


Server_Pool_Tasks=60
Server_Max_Concurrent_Trans=30

Sehr stark genutzter Hub:


Server_Pool_Tasks=100
Server_Max_Concurrent_Trans=40

Hinweise & Stolperfallen

Server-Neustart erforderlich: Der Thread-Pool wird beim Server-Start angelegt. set config Server_Pool_Tasks=… zur Laufzeit ändert nur die notes.ini, nicht den laufenden Pool.

RAM-Bedarf: Jeder Thread hält eine eigene Stack-Allocation (typ. 1–2 MB). Bei Server_Pool_Tasks=100 à 3 Ports also grob 300–600 MB Working-Set zusätzlich.

Sweet-Spot suchen: Zu viele Threads führen zu Context-Switching-Overhead und können die Performance verschlechtern. Schrittweise erhöhen (40 → 60 → 80 → 100) und Statistiken vergleichen.

Nicht mit Replicators verwechseln: Replicators skaliert separate Replicator-Tasks, Server_Pool_Tasks skaliert NRPC-Worker-Threads.

Pro-Port-Multiplikation beachten: Auf Servern mit vielen Notes-Ports (z. B. zusätzlicher ClusterPort) multipliziert sich der Wert mit der Port-Anzahl.

Monitoring: show stat Server.Trans.*, show stat Server.Pools.* (wo verfügbar), show server und Plattform-Tools (Performance Monitor / top / pidstat).

Funktioniert auf allen unterstützten Plattformen.

Quellen (HCL Product Documentation)

HCL Support Knowledge Base KB0032882 – Server_Max_Concurrent_Trans notes.ini parameter usage (Beziehung zwischen Server_Max_Concurrent_Trans und Server_Pool_Tasks, Default 40 als Ausgangspunkt): support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0032882

HCL Support Knowledge Base KB0037705 – How to set the NRPC thread pool size for each Notes port in Domino (Default 40 pro Notes-Port, Empfehlung max. 100 Threads insgesamt, keine port-spezifische Konfiguration): support.hcl-software.com/csm?id=kb_article&sysparm_article=KB0037705

HCL Domino 11.0.1 Administrator Help – N8Mail and N7Mail workloads (HCL-SUT-Tuning-Beispiel: Server_Pool_Tasks=100, Server_Max_Concurrent_Trans=100): help.hcl-software.com/domino/11.0.1/admin/tune_n8mailandn7mailworkloads_t.html

HCL Notes and Domino Wiki – NOTES.INI Settings: ds-infolib.hcltechsw.com/ldd/dominowiki.nsf/dx/NOTES.INI_Settingsd901

Hinweis: Zu Server_Pool_Tasks existiert kein eigener Reference-Eintrag im offiziellen help.hcl-software.com/domino/-Doku-Stamm — weder für Domino 14.0 (conf_server_pool_tasks_r.html → 404) noch für 14.5.1. Die Best-Practice-Empfehlungen stammen ausschließlich aus den genannten KB-Artikeln und Tuning-Topics.