Cómo modificar la configuración de la memoria en Java

Según tus requisitos de tráfico y procesamiento, es posible que debas cambiar el tamaño de la memoria del heap o el tamaño de los metadatos de la clase para los nodos que ejecutan componentes de Private Cloud basados en Java.

En esta sección, se proporcionan los tamaños de memoria del montón de Java predeterminados y recomendados, así como el proceso para cambiar los valores predeterminados. Por último, en esta sección, se describe cómo cambiar otros parámetros de configuración de la JVM con archivos de propiedades.

Tamaños de memoria de pila predeterminados y recomendados

En la siguiente tabla, se indican los tamaños de memoria del heap de Java predeterminados y recomendados para los componentes de la nube privada basados en Java:

Componente Nombre de archivo de propiedades Tamaño del montón predeterminado
Recomendado
Tamaño del heap
Tiempo de ejecución
Cassandra N/A Configurado automáticamente1 Configurado automáticamente1
Message Processor message‑processor.properties 512 MB 3 a 6 GB2
Router router.properties 512 MB 512 MB
Analytics
Servidor de Postgres postgres‑server.properties 512 MB 512 MB
Servidor Qpid qpid‑server.properties 512 MB 2 a 4 GB
Administración
Servidor de administración management‑server.properties 512 MB 512 MB
IU ui.properties 512 MB 512 MB
SymasLDAP N/A App nativa3 App nativa3
Zookeeper zookeeper.properties 2,048 MB 2,048 MB
Notas

1 Cassandra calcula de forma dinámica el tamaño máximo del montón cuando se inicia. Actualmente, es la mitad de la memoria total del sistema, con un máximo de 8192 MB. Para obtener información sobre cómo configurar el tamaño del montón, consulta Cómo cambiar el tamaño de la memoria del montón.

2 Para los procesadores de mensajes, Apigee recomienda que establezcas el tamaño del heap entre 3 y 6 GB. Aumenta el tamaño del heap más allá de los 6 GB solo después de realizar pruebas de rendimiento.

Si el uso del montón se acerca al límite máximo durante las pruebas de rendimiento, aumenta el límite máximo. Para obtener información sobre cómo configurar el tamaño del montón, consulta Cómo cambiar el tamaño de la memoria del montón.

3 No todos los componentes de Private Cloud se implementan en Java. Como no se basan en Java, las apps que se ejecutan de forma nativa en la plataforma host no tienen tamaños de pila de Java configurables. En cambio, dependen del sistema host para la administración de la memoria.

Para determinar cuánta memoria total recomienda Apigee que asignes a tus componentes basados en Java en un nodo, suma los valores que se indican arriba para cada componente en ese nodo. Por ejemplo, si tu nodo aloja los servidores de Postgres y Qpid, Apigee recomienda que la asignación de memoria combinada sea de entre 2.5 GB y 4.5 GB.

Para obtener una lista del hardware requerido (como la RAM), consulta los requisitos de instalación.

Cómo cambiar los tamaños de la memoria del montón

Para cambiar la configuración de la memoria del montón, edita el archivo de propiedades del componente. Por ejemplo, para el procesador de mensajes, edita el archivo /opt/apigee/customer/application/message-processor.properties.

Si el archivo message-processor.properties no existe o si no existe el archivo .properties correspondiente para algún componente de Edge, créalo y, luego, cambia la propiedad del archivo al usuario "apigee", como se muestra en el siguiente ejemplo:

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

Si el componente está instalado en varias máquinas, como el procesador de mensajes, debes editar el archivo de propiedades en todas las máquinas que alojan el componente.

En la siguiente tabla, se enumeran las propiedades que editas para cambiar los tamaños del montón:

Propiedad Descripción
bin_setenv_min_mem

Es el tamaño mínimo del montón. El valor predeterminado se basa en los valores que se indican en Tamaños de memoria de montón predeterminados y recomendados.

Este parámetro de configuración corresponde a la opción -Xms de Java.

bin_setenv_max_mem

Es el tamaño máximo del montón. El valor predeterminado se basa en los valores que se indican en Tamaños de memoria de montón predeterminados y recomendados.

Este parámetro de configuración corresponde a la opción -Xmx de Java.

bin_setenv_meta_space_size

Es el tamaño predeterminado de los metadatos de la clase. El valor predeterminado se establece en el valor de bin_setenv_max_permsize, que es de 128 MB de forma predeterminada. En el procesador de mensajes, Apigee recomienda que establezcas este valor en 256 MB o 512 MB, según tu tráfico.

Este parámetro de configuración corresponde a la opción -XX:MetaspaceSize de Java.

Cuando configures las propiedades del tamaño del heap en un nodo, usa el sufijo "m" para indicar megabytes, como se muestra en el siguiente ejemplo:

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

Después de establecer los valores en el archivo de propiedades, reinicia el componente:

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

Por ejemplo:

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

Cómo cambiar otras propiedades de JVM

Para los parámetros de configuración de Java que no controlan las propiedades mencionadas anteriormente, también puedes establecer lo siguiente en el archivo de propiedades correspondiente para cualquier componente de Edge:

  • bin_setenv_ext_jvm_opts: Establece cualquier propiedad de Java que no se especifique con otras propiedades. Por ejemplo:
    bin_setenv_ext_jvm_opts=-XX:MaxGCPauseMillis=500

    Sin embargo, no uses bin_setenv_ext_jvm_opts para establecer -Xms, -Xmx o -XX:MetaspaceSize, ya que estos valores se controlan con las propiedades mencionadas anteriormente.

Para obtener sugerencias adicionales sobre cómo configurar la memoria para los componentes de la nube privada, consulta este artículo en los foros de Edge.