修改 Java 記憶體設定

視流量和處理需求而定,您可能需要變更執行以 Java 為基礎的私有雲端元件的節點的堆積區記憶體大小或類別中繼資料大小。

本節提供預設和建議的 Java 堆積記憶體大小,以及變更預設值的程序。最後,本節將說明如何使用屬性檔案變更其他 JVM 設定。

預設和建議的堆積記憶體大小

下表列出以 Java 為基礎的私有雲端元件的預設和建議 Java 堆積記憶體大小:

元件 資源檔案名稱 預設
堆積大小
建議
堆積大小
執行階段
Cassandra 不適用 已自動設定1 自動設定1
訊息處理器 message-processor.properties 512 MB 3GB - 6GB2
路由器 router.properties 512 MB 512 MB
數據分析
Postgres 伺服器 postgres-server.properties 512 MB 512 MB
Qpid 伺服器 qpid-server.properties 512 MB 2GB - 4GB
管理
管理伺服器 management-server.properties 512 MB 512 MB
UI ui.properties 512 MB 512 MB
OpenLDAP 不適用 原生應用程式3 原生應用程式3
Zookeeper zookeeper.properties 2048 MB 2048 MB
附註

1 Cassandra 會在啟動時動態計算堆積大小上限。目前,這項值為系統總記憶體的一半,上限為 8192 MB。如要瞭解如何設定堆積大小,請參閱「變更堆積記憶體大小」。

2 針對訊息處理器,Apigee 建議您將堆積大小設為 3 GB 至 6 GB 之間。請務必先進行效能測試,再將堆積大小增加到超過 6 GB。

如果效能測試期間的堆積用量接近上限,請提高上限。如要瞭解如何設定堆積大小,請參閱「變更堆積記憶體大小」。

3 並非所有 Private Cloud 元件都是以 Java 實作。由於不是以 Java 為基礎,因此在主機平台上原生執行的應用程式沒有可設定的 Java 堆積大小;相反地,它們會依賴主機系統來管理記憶體。

如要判斷 Apigee 建議您為節點上的 Java 元件分配多少記憶體總量,請將上述節點上每個元件的值加總。舉例來說,如果節點同時代管 Postgres 和 Qpid 伺服器,Apigee 建議您將記憶體分配總量設為 2.5 GB 至 4.5 GB。

如需必要硬體 (例如 RAM) 清單,請參閱安裝需求

變更堆積記憶體大小

如要變更堆積記憶體設定,請編輯元件的屬性檔案。例如,針對訊息處理器,請編輯 /opt/apigee/customer/application/message-processor.properties 檔案。

如果 message-processor.properties 檔案不存在,或任何 Edge 元件的對應 .properties 檔案不存在,請建立檔案,然後將檔案的擁有權變更為「apigee」使用者,如以下範例所示:

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

如果元件安裝在多部機器上 (例如訊息處理器),您就必須在代管元件的所有機器上編輯屬性檔案。

下表列出您可以編輯來變更堆積大小的屬性:

屬性 說明
bin_setenv_min_mem

堆積大小下限。預設值是根據「預設和建議的堆積記憶體大小」一節所列的值。

這項設定對應至 Java -Xms 選項。

bin_setenv_max_mem

堆積大小上限。預設值是根據「預設和建議的堆積記憶體大小」一節所列的值。

這項設定對應至 Java -Xmx 選項。

bin_setenv_meta_space_size

預設的類別中繼資料大小。預設值為 bin_setenv_max_permsize 的值,預設為 128 MB。在訊息處理器上,Apigee 建議您將這個值設為 256 MB 或 512 MB,視流量而定。

這項設定對應至 Java -XX:MetaspaceSize 選項。

在節點上設定堆積大小屬性時,請使用「m」後置字元表示兆位元組,如以下範例所示:

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

設定屬性檔案中的值後,重新啟動元件:

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

例如:

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

變更其他 JVM 屬性

對於未受上述屬性控制的 Java 設定,您也可以為任何 Edge 元件傳入額外的 JVM 標記或值。*.properties 檔案會由 Bash 讀取,且應以 '(單引號) 括住,以便保留常值字元或 "(雙引號),如果您需要殼層擴充。

  • bin_setenv_ext_jvm_opts:設定其他屬性未指定的任何 Java 屬性。例如:
    bin_setenv_ext_jvm_opts='-XX:MaxGCPauseMillis=500'

    不過,請勿使用 bin_setenv_ext_jvm_opts 設定 -Xms-Xmx-XX:MetaspaceSize,因為這些值是由上述屬性控制。

如要進一步瞭解如何為 Private Cloud 元件設定記憶體,請參閱 Edge 論壇的這篇文章