Como modificar configurações de memória do Java

Dependendo dos requisitos de tráfego e processamento, talvez seja necessário mudar o tamanho da memória de heap ou dos metadados de classe dos nós que executam componentes do Cloud privado baseados em Java.

Esta seção fornece os tamanhos de memória de heap Java padrão e recomendados, bem como o processo para mudar os padrões. Por fim, esta seção descreve como mudar outras configurações da JVM usando arquivos de propriedades.

Tamanhos de memória de heap padrão e recomendados

A tabela a seguir lista os tamanhos de memória de heap Java padrão e recomendados para componentes de nuvem privada baseados em Java:

Componente Nome do arquivo de propriedades Tamanho do heap padrão
 Tamanho do heap
recomendado
Ambiente de execução
Cassandra N/A Configurado automaticamente1 Configurado automaticamente1
processador de mensagens message‑processor.properties 512 MB 3 GB a 6 GB2
Roteador router.properties 512 MB 512 MB
Google Analytics
Servidor Postgres postgres‑server.properties 512 MB 512 MB
Servidor Qpid qpid‑server.properties 512 MB 2 GB a 4 GB
Administração
Servidor de gerenciamento management‑server.properties 512 MB 512 MB
Interface ui.properties 512 MB 512 MB
SymasLDAP N/A App nativo3 App nativo3
Zookeeper zookeeper.properties 2.048 MB 2.048 MB
Observações

1: o Cassandra calcula dinamicamente o tamanho máximo do heap quando é iniciado. Atualmente, esse valor é metade da memória total do sistema, com um máximo de 8.192 MB. Para informações sobre como definir o tamanho do heap, consulte Mudar o tamanho da memória de heap.
2 Para processadores de mensagens, a Apigee recomenda definir o tamanho do heap entre 3 GB e 6 GB. Aumente o tamanho do heap além de 6 GB somente depois de realizar testes de performance.

Se o uso do heap se aproximar do limite máximo durante o teste de performance, aumente o limite máximo. Para informações sobre como definir o tamanho do heap, consulte Mudar o tamanho da memória de heap.
3 Nem todos os componentes da nuvem privada são implementados em Java. Como não são baseados em Java, os apps executados nativamente na plataforma host não têm tamanhos de heap Java configuráveis. Em vez disso, eles dependem do sistema host para o gerenciamento de memória.

Para determinar quanta memória total a Apigee recomenda alocar aos seus componentes baseados em Java em um nó, adicione os valores listados acima para cada componente nesse nó. Por exemplo, se o nó hospedar os servidores Postgres e Qpid, a Apigee recomenda que a alocação de memória combinada seja entre 2,5 GB e 4,5 GB.

Para uma lista de hardware necessário (como RAM), consulte Requisitos de instalação.

Mudar os tamanhos da memória de heap

Para mudar as configurações de memória de heap, edite o arquivo de propriedades do componente. Por exemplo, para o processador de mensagens, edite o arquivo /opt/apigee/customer/application/message-processor.properties.

Se o arquivo message-processor.properties não existir ou se o arquivo .properties correspondente de qualquer componente do Edge não existir, crie-o e mude a propriedade para o usuário "apigee", como mostra o exemplo a seguir:

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

Se o componente estiver instalado em várias máquinas, como o processador de mensagens, edite o arquivo de propriedades em todas as máquinas que hospedam o componente.

A tabela a seguir lista as propriedades que você edita para mudar os tamanhos de heap:

Propriedade Descrição
bin_setenv_min_mem

O tamanho mínimo do heap. O padrão é baseado nos valores listados em Tamanhos padrão e recomendados de memória de heap.

Essa configuração corresponde à opção -Xms do Java.
bin_setenv_max_mem

O tamanho máximo do heap. O padrão é baseado nos valores listados em Tamanhos padrão e recomendados de memória de heap.

Essa configuração corresponde à opção -Xmx do Java.
bin_setenv_meta_space_size

O tamanho padrão dos metadados da classe. O valor padrão é definido como o valor de bin_setenv_max_permsize, que é 128 MB por padrão. No processador de mensagens, a Apigee recomenda definir esse valor como 256 MB ou 512 MB, dependendo do tráfego.

Essa configuração corresponde à opção -XX:MetaspaceSize do Java.

Ao definir propriedades de tamanho de heap em um nó, use o sufixo "m" para indicar megabytes, como mostra o exemplo a seguir:

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

Depois de definir os valores no arquivo de propriedades, reinicie o componente:

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

Exemplo:

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

Mudar outras propriedades da JVM

Para configurações do Java não controladas pelas propriedades listadas acima, também é possível definir o seguinte no arquivo de propriedades correspondente para qualquer componente do Edge:

  • bin_setenv_ext_jvm_opts: defina qualquer propriedade Java não especificada por outras propriedades. Exemplo: 
    bin_setenv_ext_jvm_opts=-XX:MaxGCPauseMillis=500

    No entanto, não use bin_setenv_ext_jvm_opts para definir -Xms, -Xmx ou -XX:MetaspaceSize, já que esses valores são controlados pelas propriedades listadas acima.

Para mais dicas sobre como configurar a memória para componentes da nuvem privada, consulte este artigo nos fóruns do Edge.