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

Dependendo dos requisitos de tráfego e processamento, talvez seja necessário alterar o tamanho da memória de heap ou o tamanho dos metadados de classe para os nós que executam componentes de nuvem privada baseados em Java.

Esta seção fornece os tamanhos de memória de heap Java padrão e recomendados, bem como o processo para alterar os padrões. Por fim, esta seção descreve como alterar 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 padrão e recomendados de memória de heap Java para componentes de nuvem privada baseados em Java:

Componente Nome do arquivo de propriedades Tamanho de heap
padrão
Tamanho de 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
OpenLDAP N/A Aplicativo nativo3 Aplicativo nativo3
Zookeeper zookeeper.properties 2.048 MB 2.048 MB
Observações

1 O Cassandra calcula dinamicamente o tamanho máximo de heap quando é iniciado. Atualmente, isso representa metade da memória total do sistema, com um máximo de 8.192 MB. Para informações sobre como definir o tamanho da memória heap, consulte Alterar o tamanho da memória de heap.

2 Para processadores de mensagens, a Apigee recomenda que o tamanho do heap seja de 3 GB a 6 GB. Aumente o tamanho de heap além de 6 GB somente após realizar testes de desempenho.

Se o uso de heap se aproximar do limite máximo durante o teste de desempenho, aumente o limite máximo. Para informações sobre a definição do tamanho da memória heap, consulte Alterar o tamanho da memória de heap.

3 Nem todos os componentes de nuvem privada são implementados em Java. Por não serem 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 gerenciamento de memória.

Para determinar a quantidade total de memória que a Apigee recomenda que você aloque aos 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 ver uma lista do hardware necessário (como a RAM), consulte Requisitos de instalação.

Alterar tamanhos da memória de heap

Para alterar as configurações da memória 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 a qualquer componente do Edge não existir, crie-o e mude a propriedade do arquivo para o usuário "apigee", conforme mostrado no 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, você precisará editar o arquivo de propriedades em todas as máquinas que hospedam o componente.

A tabela a seguir lista as propriedades editadas para alterar os tamanhos de heap:

Propriedade Descrição
bin_setenv_min_mem

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

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

bin_setenv_max_mem

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

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 bin_setenv_max_permsize, que tem como padrão 128 MB. No processador de mensagens, a Apigee recomenda que você defina esse valor como 256 MB ou 512 MB, dependendo do tráfego.

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

Ao definir as 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 de 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: define qualquer propriedade Java não especificada por outras propriedades. Por 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, porque 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.