Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Sintomo
Il router Edge viene implementato tramite NGINX. Durante il processo di upgrade di Edge o durante la modifica della configurazione del router, potresti vedere errori di configurazione NGINX. Quando si verificano questi
errori, Edge contrassegna tutti i file di configurazione NGINX che hanno causato il problema su
/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
Messaggi di errore
Non verrà visualizzato alcun messaggio di errore. Tuttavia, potresti non essere in grado di eseguire i proxy API a causa dei file di configurazione non validi.
Possibili cause
In genere i file di configurazione NGINX sono contrassegnati come non validi perché i valori errati sono impostati sulle proprietà NGINX nel file /opt/apigee/customer/application/router.properties
oppure vengono apportate modifiche errate a un host virtuale.
Diagnostica
- Rimuovi il suffisso .bad dai nomi dei file nella directory
/opt/nginx/conf.d
in modo che terminino con .conf.
- Esegui lo strumento NGINX configtest per determinare il motivo dell'errore:
/opt/nginx/scripts/apigee-nginx configtest
Risoluzione
- Se il test di configurazione identifica il motivo dei file di configurazione errati, risolvi il problema apportando le modifiche appropriate alla proprietà specifica nel file
/opt/apigee/customer/application/router.properties
o nell'host virtuale.
- Rimuovi la directory
/opt/nginx/conf.d
:rm -rf /opt/nginx/conf.d
- Riavvia il router:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Non dovresti più vedere file di configurazione errati nella directory
/opt/nginx/conf.d
.
Se il problema persiste, contatta l'assistenza Apigee Edge.
Ecco un esempio che mostra come risolvere il problema in base alle informazioni fornite dal test di configurazione NGINX.
Esempio 1: valore errato impostato per una proprietà NGINX
- Supponiamo che tu abbia aggiornato la proprietà "proxy_busy_buffers_size"
impostandola su 128 kB nel file
/opt/apigee/customer/application/router.properties
, come mostrato di seguito:conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=128k
Di conseguenza, i file di configurazione sono stati contrassegnati come non validi nella directory /opt/apigee/nginx/conf.d
.
- Esegui il comando NGINX configtest per determinare il motivo dell'errore:
/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
I risultati del test di configurazione indicano che il valore della proprietà proxy_busy_buffers_size deve essere uguale o superiore a proxy_busy_buffers_size, ma sembra che sia impostato con un valore errato.
- Controlla i valori impostati per le proprietà proxy_buffer_size e proxy_occupato_buffers_size nel file
0-default.conf
:proxy_buffer_size 512k; proxy_busy_buffers_size 128k;
- Aggiorna il valore di proxy_occupato_buffers_size a 512 K nel
file
/opt/apigee/customer/application/router.properties
:conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k
- Rimuovi la cartella
/opt/nginx/conf.d
:rm -rf /opt/nginx/conf.d
- Riavvia il router:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
Il problema è stato risolto e i file di configurazione non validi sono stati rimossi.
Esempio 2: il processo non riesce a eseguire l'upgrade di NGINX (solo Private Cloud 18.01)
Supponiamo che esegui configtest
e restituisci le seguenti risposte:
/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
Questo errore indica che il processo non è riuscito a eseguire l'upgrade di NGINX da 1.10.x a 1.12.x. Esiste un bug noto relativo all'upgrade di Edge Private Cloud alla versione 18.01.
Per diagnosticare correttamente questo problema (solo se utilizzi Private Cloud 18.01), procedi come segue:
rpm -aq | grep apigee-nginx
Questo comando dovrebbe restituire il valore rpm installato come versione 1.12.x. In caso contrario, procedi nel seguente modo:
- Arresta il componente perimetrale del router.
- Esegui il backup del componente Edge-router.
- Esegui questo comando per eseguire l'upgrade ad apigee-nginx 1.2.x:
- Elimina tutti e
*.bad
i file in/opt/apigee/nginx/conf.d.
- Riavvia il componente Edge-router.
sudo yum update apigee-nginx