Start/notes.ini Parameter/HTTPJVMMaxHeapSize

HTTPJVMMaxHeapSize

Parameter: HTTPJVMMaxHeapSize
Kurzbeschreibung: Setzt die maximale Heap-Größe der JVM, die der Domino HTTP-Task (XPages, Servlets, Java-DSAPI) verwendet. Default: 1 GB.

Steckbrief

Parameter
HTTPJVMMaxHeapSize
Komponente
Server (HTTP-Task / nhttp)
Kategorie
HTTP / Web (JVM)
Verfügbar seit
9.0.x (gemäß KB0029777)
Default
1 GB auf HCL Domino Server
Werte
Bytes oder mit Suffix M/MB/G/GB
Wirkungsbereich
Ausschließlich der HTTP-Prozess
Aktivierung
Neustart des HTTP-Tasks (tell http restart)

Beschreibung

In Domino existieren zwei separate Stellschrauben für die JVM-Heap-Größe:
  • HTTPJVMMaxHeapSize setzt den Heap nur für den HTTP-Prozess (nhttp) – also für alles, was im HTTP-Stack Java verwendet (XPages, Servlets, Java-DSAPI).
  • JavaMaxHeapSize (separater Parameter) setzt den Heap für alle anderen Domino-Server-Prozesse, die eine JVM laden (z. B. Agent Manager amgr, periodische Java-Agents, runjava).
Laut HCL Customer Support (KB0029777) liegt der Standardwert auf HCL Domino Server bei 1 GB. Bei JavaMaxHeapSize ist der Default 256 MB.

Beispiele

HTTPJVMMaxHeapSize=1024M
HTTPJVMMaxHeapSize=2G
HTTPJVMMaxHeapSize=67108864

Praxis-Hinweise

  • OutOfMemory im HTTP-Task – Meldungen vom Typ java.lang.OutOfMemoryError aus nhttp deuten typischerweise auf einen zu klein gesetzten HTTPJVMMaxHeapSize. Heap-Dumps und Verbose-GC können vor einer Erhöhung helfen, eine Leck-Ursache auszuschließen.
  • Adressraum – Auf 64-Bit-Systemen ist Spielraum gegeben, auf 32-Bit-Systemen schränkt jeder zusätzlich reservierte Heap den verfügbaren Adressraum für nhttp ein.
  • Aktivierung – Änderungen werden mit dem nächsten HTTP-Restart wirksam (tell http restart an der Server-Konsole oder Server-Neustart).
  • Trennung beachten – Eine Erhöhung von JavaMaxHeapSize allein verändert nichts am HTTP-Heap und umgekehrt.

Quellen (HCL Product Documentation)