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 montón o el tamaño de los metadatos de clase de los nodos que ejecutan componentes de la nube privada basados en Java.

En esta sección, se proporcionan los tamaños de memoria predeterminados y recomendados del montón de Java, 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 JVM con archivos de propiedades.

Tamaños de memoria de pila predeterminados y recomendados

En la siguiente tabla, se enumeran los tamaños de memoria de montón de Java predeterminados y recomendados para los componentes de la nube privada basados en Java:

Componente Nombre del archivo de propiedades Tamaño del montón
predeterminado
Tamaño de montón
recomendado
Tiempo de ejecución
Cassandra N/A Se configura automáticamente1 Se configura automáticamente1
Message Processor message-processor.properties 512 MB De 3 GB 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 De 2 GB a 4 GB
Administración
Servidor de administración management-server.properties 512 MB 512 MB
IU ui.properties 512 MB 512 MB
OpenLDAP N/A Aplicación nativa3 Aplicación 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. En la actualidad, corresponde a la mitad de la memoria total del sistema, con un máximo de 8,192 MB. Para obtener información sobre cómo establecer 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 montón entre 3 GB y 6 GB. Aumenta el tamaño del montón a más de 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 establecer 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 la Nube privada se implementan en Java. Debido a que 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 su lugar, dependen del sistema host para la administración de memoria.

Para determinar cuánta memoria total recomienda Apigee que asignes a los componentes basados en Java en un nodo, agrega los valores mencionados anteriormente para cada componente en ese nodo. Por ejemplo, si tu nodo aloja los servidores Postgres y Qpid, Apigee recomienda que tu 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 Requisitos de instalación.

Cambia los tamaños de 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 ningú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 Message Processor, 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 del 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 del 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 de metadatos de clase predeterminado. 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.

Esta configuración corresponde a la opción -XX:MetaspaceSize de Java.

Cuando establezcas propiedades de tamaño del montón 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

Cambia otras propiedades de JVM

En el caso de la configuración de Java no controlada por las propiedades mencionadas anteriormente, también puedes pasar marcas o valores de JVM adicionales para cualquier componente de Edge. Bash leerá los archivos *.properties y estos se deben encerrar entre '(comillas simples) para conservar los caracteres literales o "(comillas dobles) si necesitas una expansión de shell.

  • bin_setenv_ext_jvm_opts: Configura cualquier propiedad de Java que no esté especificada por otras propiedades. Por ejemplo:
    bin_setenv_ext_jvm_opts='-XX:MaxGCPauseMillis=500'
    .

    Sin embargo, no uses bin_setenv_ext_jvm_opts para configurar -Xms, -Xmx o -XX:MetaspaceSize, ya que estos valores están controlados por las propiedades mencionadas anteriormente.

Para obtener más sugerencias sobre la configuración de la memoria para los componentes de la nube privada, consulta este artículo en los foros de Edge.