Start/notes.ini Parameter/JavaMaxHeapSize

JavaMaxHeapSize

🛠️
Parameter: JavaMaxHeapSize
Kurzbeschreibung: Maximale Heap-Größe der Java-VM, die Domino für Java-Agenten und HTTP-bezogene Java-Komponenten startet.

Steckbrief

Parameter
JavaMaxHeapSize
Kategorie
Client-Konfiguration
Komponente
Server, Client
Verfügbar seit
9.0
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Server-Dokument
Mögliche Werte
Speicherangabe inkl. Suffix, z. B. 256M, 1024M, 2G

Beschreibung

Java-Agenten, das HTTP-Servlet-Engine-Subsystem sowie Erweiterungen wie XPages laufen in einer JVM, deren Heap durch JavaMaxHeapSize begrenzt wird. Zu kleine Werte führen zu OutOfMemoryError in Agenten oder Web-Anwendungen, zu große Werte vergeuden RAM und führen auf 32-Bit-Plattformen sogar zu Startfehlern. Standardmäßig liegt der Wert bei 256M; für produktive Server mit XPages-/REST-Apps sind 512M – 2G praxisüblich.

Beispiel-Konfiguration

JavaMaxHeapSize=1024M

Hinweise & Stolperfallen

  • Wert auf 64-Bit-Plattformen unbedingt ≥ 512M setzen, wenn XPages oder größere Java-Agenten genutzt werden.
  • Erfordert Neustart der nutzenden Tasks (HTTP, AMgr) oder einen Server-Restart.
  • Bei Speicherengpässen vorher mit Java-Profiling/Heapdumps die tatsächliche Last messen.
  • Der gleiche Parameter ist auch im Notes Client wirksam (z. B. für lokale Java-Agenten).