Java-Speichereinstellungen ändern

Abhängig von Ihren Traffic- und Verarbeitungsanforderungen müssen Sie möglicherweise die Größe des Heap-Arbeitsspeichers oder die Größe der Klassenmetadaten für Ihre Knoten ändern, auf denen Java-basierte Private Cloud-Komponenten ausgeführt werden.

Dieser Abschnitt enthält die standardmäßigen und empfohlenen Größen des Java-Heap-Speichers sowie das Verfahren zum Ändern der Standardwerte. In diesem Abschnitt wird schließlich beschrieben, wie Sie mithilfe von Attributdateien andere JVM-Einstellungen ändern.

Standardgröße und empfohlene Heap-Speichergrößen

In der folgenden Tabelle sind die standardmäßigen und empfohlenen Java-Heap-Speichergrößen für Java-basierte Private Cloud-Komponenten aufgeführt:

Komponente	Eigenschaftendateiname	Standard- Heap-Größe	Empfohlene Heap-Größe
Laufzeit
Cassandra	–	Automatisch konfiguriert1	Automatisch konfiguriert1
Message Processor	message‑processor.properties	512 MB	3–6 GB2
Router	router.properties	512 MB	512 MB
Analytics
Postgres-Server	postgres‑server.properties	512 MB	512 MB
QPID-Server	qpid‑server.properties	512 MB	2–4 GB
Verwaltung
Verwaltungsserver	management‑server.properties	512 MB	512 MB
UI	ui.properties	512 MB	512 MB
OpenLDAP	–	Native App3	Native App3
Zookeeper	zookeeper.properties	2.048 MB	2.048 MB
Hinweise
1 Cassandra berechnet die maximale Heap-Größe beim Start dynamisch. Derzeit entspricht dies der Hälfte des gesamten Systemspeichers mit maximal 8.192 MB. Informationen zum Festlegen der Heap-Größe finden Sie unter Heap-Speichergröße ändern.
2 Für Message Processor empfiehlt Apigee, die Heap-Größe zwischen 3 GB und 6 GB festzulegen. Erhöhen Sie die Heap-Größe erst auf über 6 GB hinaus, nachdem Sie Leistungstests durchgeführt haben. Erhöhen Sie das Limit, wenn sich die Heap-Nutzung während des Leistungstests dem Höchstlimit nähert. Informationen zum Festlegen der Heap-Größe finden Sie unter Heap-Speichergröße ändern.
3 Nicht alle Private Cloud-Komponenten sind in Java implementiert. Da sie nicht Java-basiert sind, haben Anwendungen, die nativ auf der Hostplattform ausgeführt werden, keine konfigurierbaren Java-Heap-Größen. Stattdessen verlassen sie sich für die Speicherverwaltung auf das Hostsystem.

Fügen Sie die oben aufgeführten Werte für jede Komponente auf diesem Knoten hinzu, um zu bestimmen, wie viel Gesamtarbeitsspeicher von Apigee Ihren Java-basierten Komponenten auf einem Knoten zugewiesen werden sollte. Wenn Ihr Knoten beispielsweise sowohl die Postgres- als auch die Qpid-Server hostet, empfiehlt Apigee, dass die kombinierte Arbeitsspeicherzuweisung zwischen 2,5 GB und 4,5 GB liegt.

Eine Liste der erforderlichen Hardware (z. B. RAM) finden Sie unter Installationsanforderungen.

Größe des Heap-Speichers ändern

Wenn Sie die Einstellungen für den Heap-Speicher ändern möchten, bearbeiten Sie die Eigenschaftendatei der Komponente. Bearbeiten Sie beispielsweise für den Message Processor die Datei /opt/apigee/customer/application/message-processor.properties.

Wenn die Datei message-processor.properties nicht vorhanden ist oder die entsprechende .properties-Datei für eine Edge-Komponente nicht vorhanden ist, erstellen Sie sie und übertragen Sie die Eigentümerschaft der Datei auf den „apigee“-Nutzer, wie das folgende Beispiel zeigt:

chown apigee:apigee /opt/apigee/customer/application/message-processor.properties

Wenn die Komponente auf mehreren Computern installiert ist, z. B. auf dem Message Processor, musst du die Attributdatei auf allen Computern bearbeiten, auf denen die Komponente gehostet wird.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die Sie zum Ändern der Heap-Größen bearbeiten:

Attribut	Beschreibung
bin_setenv_min_mem	Die minimale Heap-Größe. Der Standardwert basiert auf den Werten, die unter Standardgröße und empfohlene Heap-Speichergrößen aufgeführt sind. Diese Einstellung entspricht der Java-Option -Xms.
bin_setenv_max_mem	Die maximale Heap-Größe. Der Standardwert basiert auf den Werten, die unter Standardgröße und empfohlene Heap-Speichergrößen aufgeführt sind. Diese Einstellung entspricht der Java-Option -Xmx.
bin_setenv_meta_space_size	Die Standardgröße der Klassenmetadaten. Der Standardwert ist bin_setenv_max_permsize (standardmäßig 128 MB). Im Message Processor empfiehlt Apigee, diesen Wert je nach Traffic auf 256 MB oder 512 MB festzulegen. Diese Einstellung entspricht der Java-Option -XX:MetaspaceSize.

Wenn Sie Heap-Größeneigenschaften auf einem Knoten festlegen, verwenden Sie das Suffix „m“, um die Megabyte wie im folgenden Beispiel anzugeben:

bin_setenv_min_mem=4500m
bin_setenv_max_mem=4500m
bin_setenv_meta_space_size=1024m

Nachdem Sie die Werte in der Eigenschaftendatei festgelegt haben, starten Sie die Komponente neu:

/opt/apigee/apigee-service/bin/apigee-service component restart

Beispiel:

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Andere JVM-Attribute ändern

Bei Java-Einstellungen, die nicht von den oben aufgeführten Eigenschaften gesteuert werden, können Sie in der entsprechenden Eigenschaftendatei für eine Edge-Komponente auch Folgendes festlegen:

• bin_setenv_ext_jvm_opts: Legen Sie ein beliebiges Java-Attribut fest, das nicht von anderen Attributen angegeben wird. Beispiele:

  bin_setenv_ext_jvm_opts=-XX:MaxGCPauseMillis=500

  Verwenden Sie bin_setenv_ext_jvm_opts jedoch nicht, um -Xms, -Xmx oder -XX:MetaspaceSize festzulegen, da diese Werte von den oben aufgeführten Attributen gesteuert werden.

Weitere Tipps zum Konfigurieren des Arbeitsspeichers für Private Cloud-Komponenten finden Sie in diesem Artikel in den Edge-Foren.