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 heap ou o tamanho dos metadados de classe dos nós que executam componentes de nuvem privada baseada em Java.

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

Tamanhos de memória heap padrão e recomendados

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

Componente	Nome do arquivo de propriedades	Padrão Tamanho do heap	Recomendado Tamanho do heap
Ambiente de execução
Cassandra	N/A	Configurado automaticamente1	Configurado automaticamente1
processador de mensagens	message-processor.properties	512 MB	3GB - 6GB2
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 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	App nativo3	App 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, essa é 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 do 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 para mais de 6 GB somente após realizar testes de desempenho. Se o uso do heap estiver próximo 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 do 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 de forma nativa 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 a quantidade total de memória que a Apigee recomenda que você aloque para os 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 RAM), consulte Requisitos de instalação.

Mudar os tamanhos da memória de heap

Para mudar 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 para qualquer componente do Edge não existir, crie-o e altere a propriedade do arquivo para o usuário "apigee", conforme 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, você vai precisar editar o arquivo de propriedades em todas as máquinas que hospedam o componente.

A tabela a seguir lista as propriedades que você edita 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 heap padrão e recomendados. Essa configuração corresponde à opção -Xms do Java.
bin_setenv_max_mem	O tamanho máximo da pilha. O padrão é baseado nos valores listados em Tamanhos de memória heap padrão e recomendados. Essa configuração corresponde à opção -Xmx do Java.
bin_setenv_meta_space_size	O tamanho de metadados da classe padrão. 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 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 propriedades de tamanho de heap em um nó, use o sufixo "m" para indicar megabytes, conforme mostrado no exemplo abaixo:

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 Java não controladas pelas propriedades listadas acima, também é possível transmitir sinalizações ou valores JVM adicionais para qualquer componente do Edge. Os arquivos *.properties serão lidos pelo Bash e precisarão ser delimitados por '(aspas simples) para preservar caracteres literais ou "(aspas duplas) se você precisar da expansão do shell.

• bin_setenv_ext_jvm_opts: define qualquer propriedade do 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 de nuvem privada, consulte este artigo nos fóruns do Edge.