Arquivos de configuração incorretos

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Sintoma

O roteador do Edge é implementado usando o NGINX. Durante o processo de upgrade do Edge ou ao mudar a configuração do roteador, erros de configuração do NGINX podem aparecer. Quando esses erros ocorrem, o Edge marca todos os arquivos de configuração do NGINX que causaram o problema como /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 será exibida. No entanto, talvez não seja possível executar os proxies de API devido aos arquivos de configuração incorretos.

Causas possíveis

Normalmente, os arquivos de configuração do NGINX são marcados como incorretos porque valores incorretos são definidos para as propriedades do NGINX no arquivo /opt/apigee/customer/application/router.properties ou porque mudanças 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 eles terminem em .conf.

2. 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 adequadas na propriedade específica no arquivo /opt/apigee/customer/application/router.properties ou no host virtual.

2. Remova o diretório /opt/nginx/conf.d:

   rm -rf /opt/nginx/conf.d

3. Reinicie o roteador:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

4. Os arquivos de configuração incorretos não vão mais aparecer no /opt/nginx/conf.d diretório.

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

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

Exemplo 1: valor incorreto definido para uma propriedade do NGINX

1. Digamos que você tenha atualizado a propriedade “proxy_busy_buffers_size” para 128K 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 incorretos no diretório /opt/apigee/nginx/conf.d.

2. 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_buffer_size, mas parece estar definido com um valor incorreto.

3. Verifique os valores definidos para as propriedades proxy_buffer_size e proxy_busy_buffers_size no arquivo 0-default.conf:

   proxy_buffer_size 512k;
   proxy_busy_buffers_size 128k;

4. Atualize o valor de proxy_busy_buffers_size para 512K no /opt/apigee/customer/application/router.properties arquivo:

   conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k

5. Remova a pasta /opt/nginx/conf.d:

   rm -rf /opt/nginx/conf.d

6. 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: o processo não consegue fazer upgrade do NGINX (somente no Private Cloud 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 não conseguiu fazer upgrade do NGINX da versão 1.10.x para a 1.12.x. Há um bug conhecido relacionado ao upgrade do Edge Private Cloud para a versão 18.01.

Para diagnosticar corretamente esse problema (somente se você estiver no Private Cloud 18.01), faça o seguinte:

rpm -aq | grep apigee-nginx

Esse comando precisa retornar o rpm instalado como a versão 1.12.x. Se não for o caso, siga estas etapas:

1. Interrompa o componente edge-router.
2. Faça backup do componente edge-router.
3. Execute este comando para fazer upgrade para apigee-nginx 1.2.x:

sudo yum update apigee-nginx

4. Exclua todos os arquivos *.bad em /opt/apigee/nginx/conf.d.
5. Reinicie o componente edge-router.