Arquivos de configuração incorretos

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Sintoma

O roteador de borda é implementado com o NGINX. Durante o processo de upgrade do Edge ou ao alterar a configuração do roteador, talvez você veja erros de configuração do NGINX. Quando esses erros ocorrem, o Edge marca todos os arquivos de configuração do NGINX que causaram o problema /opt/nginx/conf.d:

-rw-r--r-- 1 apigee apigee 522 Jul 20 08:41 0-default.conf.bad 
-rw-r--r-- 1 apigee apigee 577 Jul 20 08:42 0-fallback.conf 
-rw-r--r-- 1 apigee apigee 1062 Jul 20 08:18 0-map.conf 
-rw-r--r-- 1 apigee apigee 1887 Jul 20 08:42 custorg_test_default.conf.bad

Mensagens de erro

Nenhuma mensagem de erro vai aparecer. No entanto, talvez não seja possível executar os proxies da API devido aos arquivos de configuração inválidos.

Causas possíveis

Normalmente, os arquivos de configuração do NGINX são marcados como inválidos. Isso ocorre porque valores incorretos são definidos nas propriedades do NGINX no arquivo /opt/apigee/customer/application/router.properties ou alterações incorretas são feitas em um host virtual.

Diagnóstico

  1. Remova o sufixo .bad dos nomes de arquivo no diretório /opt/nginx/conf.d para que terminem em .conf.
  1. Execute a ferramenta configtest do NGINX para determinar o motivo da falha: 
    /opt/nginx/scripts/apigee-nginx configtest

Resolução

  1. Se o teste de configuração identificar o motivo dos arquivos de configuração incorretos, corrija o problema fazendo as mudanças apropriadas na propriedade específica no arquivo /opt/apigee/customer/application/router.properties ou no host virtual.
  1. Remova o diretório /opt/nginx/conf.d: 
    rm -rf /opt/nginx/conf.d
  1. Reinicie o roteador: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  1. Você não verá mais arquivos de configuração inválidos no diretório /opt/nginx/conf.d .

Se o problema persistir, entre em contato com o suporte do Apigee Edge.

Veja um exemplo que mostra como corrigir o problema com base nas informações fornecidas pelo teste de configuração do NGINX.

Exemplo 1: valor incorreto definido para uma propriedade do NGINX

  1. Digamos que você atualizou a propriedade "proxy_busy_buffers_size" para 128 K no arquivo /opt/apigee/customer/application/router.properties, conforme mostrado abaixo: 
    conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=128k

Isso fez com que os arquivos de configuração fossem marcados como inválidos no diretório /opt/apigee/nginx/conf.d.

  1. Execute o comando configtest do NGINX para determinar o motivo da falha: 
    /opt/nginx/scripts/apigee-nginx configtest
nginx: [emerg] "proxy_busy_buffers_size" must be equal to or greater than the maximum of the value of "proxy_buffer_size" and one of the "proxy_buffers" in /opt/nginx/conf/nginx.conf:47
nginx: configuration file /opt/nginx/conf/nginx.conf test failed

Os resultados do Configtest indicam que o valor da propriedade proxy_busy_buffers_size precisa ser igual ou maior que proxy_busy_buffers_size, mas parece estar definido com um valor incorreto.

  1. Verifique os valores definidos para as propriedades proxy_buffer_size e proxy_ Partner_buffers_size no arquivo 0-default.conf: 
    proxy_buffer_size 512k;
proxy_busy_buffers_size 128k;
  1. Atualize o valor de proxy_enabling_buffers_size para 512 K no arquivo /opt/apigee/customer/application/router.properties: 
    conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k
  1. Remova a pasta /opt/nginx/conf.d: 
    rm -rf /opt/nginx/conf.d
  1. Reinicie o roteador: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart

O problema foi corrigido, e os arquivos de configuração incorretos foram removidos.

Exemplo 2: falha no upgrade do NGINX (somente nuvem privada 18.01)

Digamos que você execute configtest e receba as seguintes respostas: 

/apigee-nginx configtest

 nginx: the configuration file /opt/nginx/conf/nginx.conf syntax is ok
 nginx: [emerg] zero size shared memory zone "perclient"
 nginx: configuration file /opt/nginx/conf/nginx.conf test failed

Essa falha indica que o processo falhou ao fazer upgrade do NGINX de 1.10.x para 1.12.x. Há um bug conhecido relacionado ao upgrade do Edge Private Cloud para a versão 18.01.

Para diagnosticar adequadamente esse problema (apenas se você estiver na nuvem privada 18.01), faça o seguinte:

rpm -aq | grep apigee-nginx

Esse comando deve retornar o rpm instalado como versão 1.12.x. Caso contrário, siga estas etapas:

  1. Interrompa o componente do roteador de borda.
  2. Faça backup do componente do roteador de borda.
  3. Execute este comando para fazer upgrade para o apigee-nginx 1.2.x:
    4. sudo yum update apigee-nginx
  4. Exclua todos os *.bad arquivos em /opt/apigee/nginx/conf.d.
  5. Reinicie o componente do roteador de borda.