Start/notes.ini Parameter/JavaMaxHeapSize

JavaMaxHeapSize

Parameter: JavaMaxHeapSize
Kurzbeschreibung: Setzt die maximale JVM-Heap-Größe für alle Domino-Server-Prozesse außerhalb des HTTP-Tasks (Agent Manager, periodische Java-Agents, runjava). Default: 256 MB.
JavaMaxHeapSize legt die maximale Heap-Größe der Java Virtual Machine für alle Domino-Server-Prozesse fest, die nicht der HTTP-Task sind – zum Beispiel Agent Manager (amgr), periodische Java-Agents und runjava-Aufrufe.

Steckbrief

Parameter
JavaMaxHeapSize
Komponente
Server (amgr, runjava, Java-Agents)
Kategorie
Performance / Memory (JVM)
Verfügbar seit
9.0.x (gemäß KB0029777)
Default
256 MB auf HCL Domino Server
Werte
Bytes oder mit Suffix M/MB
Wirkungsbereich
Alle JVM-Nutzer außer dem HTTP-Task
Aktivierung
Neustart der jeweiligen Tasks (z. B. restart task amgr)

Beschreibung

Domino unterscheidet zwei Stellschrauben für JVM-Heap-Größen:
  • JavaMaxHeapSize setzt den Heap für alle Domino-Prozesse, die eine eigene JVM starten – z. B. Agent Manager (amgr), periodische Java-Agents oder runjava-Aufrufe.
  • HTTPJVMMaxHeapSize setzt den Heap nur für den HTTP-Task (nhttp).
Laut HCL Customer Support (KB0029777) liegt der Default-Wert von JavaMaxHeapSize bei 256 MB, der von HTTPJVMMaxHeapSize bei 1 GB.
Die JVM startet typischerweise mit etwa 16 MB Heap und wächst bei Bedarf bis zum mit JavaMaxHeapSize definierten Maximum. Wird das Maximum erreicht, kommt es zu java.lang.OutOfMemoryError.

Beispiele

JavaMaxHeapSize=64MB
JavaMaxHeapSize=512M
JavaMaxHeapSize=67108864
Die drei Beispiele sind nicht äquivalent: 64 MB = 67.108.864 Bytes; 512 M = 512 MB.

Praxis-Hinweise

  • OutOfMemory bei Java-Agents – Meldet ein periodischer Java-Agent java.lang.OutOfMemoryError, ist JavaMaxHeapSize zu niedrig (oder der Agent hat ein Speicher-Leck).
  • Trennung von HTTP – Änderungen an JavaMaxHeapSize berühren den HTTP-Task nicht. Für XPages und Java-DSAPI ist HTTPJVMMaxHeapSize zuständig.
  • Aktivierung – Der Wert wird beim nächsten Start der jeweiligen JVM gelesen. Für Agent Manager: restart task amgr an der Server-Konsole.
  • Ältere Defaults – In sehr alten Releases galten andere Defaults (z. B. 64 MB in Domino 7/8). Auf HCL Domino Server (9.x und neuer) ist 256 MB Standard.

Quellen (HCL Product Documentation)