Start/notes.ini Parameter/HTTPJVMStack

HTTPJVMStack

🛠️
Parameter: HTTPJVMStack
Kurzbeschreibung: Stack-Größe pro Thread für die HTTP-JVM – erhöhen bei StackOverflowError in tief geschachtelten XPages-/Verse-Renderings.

Steckbrief

Parameter
HTTPJVMStack
Kategorie
Performance / Memory
Komponente
Server
Verfügbar seit
12.0
Unterstützte Versionen
12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI)
Mögliche Werte
KiB (Standard 512; typisch 512–2048)

Beschreibung

HTTPJVMStack setzt die Java-Thread-Stackgröße (-Xss) für die HTTP-JVM in KiB. Diese JVM trägt XPages, Servlets, OSGi-Plugins und die Domino REST API. Bei tief geschachtelten XPage-Komponenten, komplexen JSF-Trees oder rekursiven Custom-Controls kann der Standard-Stack zu klein sein – die JVM antwortet mit java.lang.StackOverflowError oder bricht den Request hart ab. Eine moderate Erhöhung (z. B. auf 1024) löst diese Fälle, ohne den Speicherbedarf des HTTP-Prozesses dramatisch zu erhöhen.

Beispiel-Konfiguration

HTTPJVMStack=1024

Hinweise & Stolperfallen

  • Wert in KiB (1024 = 1 MiB pro Thread).
  • Mehr Stack × mehr Worker-Threads (HTTP_MaxActiveThreads) = spürbar höherer RAM-Verbrauch.
  • Greift erst nach restart task http.
  • Nicht zu hoch ansetzen: >4096 ist meist ein Workaround für ein eigentliches Code-Problem (Endlos-Rekursion).
  • Bei wiederkehrendem StackOverflowError zusätzlich Heap-/Thread-Dumps auswerten.